# Transfer lockboxes between accounts

Moves lockboxes between accounts. The user must have access to both the lockboxes and the target account.

Endpoint: POST /lockboxes/transfer_accounts
Version: 1.1.1
Security: BearerAuth

## Request fields (application/json):

  - `lockbox_ids` (array, required)
    List of lockbox IDs to be transferred to the new account
    Example: ["123e4567-e89b-12d3-a456-426614174000","123e4567-e89b-12d3-a456-426614174001"]

  - `new_account_id` (string, required)
    ID of the account to which the lockboxes should be transferred
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier

  - `lockbox_type` (string, required)
    Type of lockbox
    Enum: "Sentrilock"

  - `serial_number` (string, required)
    Serial number of the lockbox
    Example: "1234567"

  - `account_id` (string, required)
    ID of the account that owns the lockbox
    Example: "4b88ff32-8ba0-4bbf-8e60-c789909ac176"

  - `created_at` (string, required)
    Timestamp when the lockbox was created
    Example: "2023-01-15T12:00:00Z"

  - `updated_at` (string, required)
    Timestamp when the lockbox was last updated
    Example: "2023-01-16T14:30:00Z"

## Response 400 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 403 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (array)
    Detailed error information
    Example: [{"keyword":"required","dataPath":"","schemaPath":"#/required","params":{"missingProperty":"account_id"},"message":"should have required property 'account_id'"}]