> ## Documentation Index
> Fetch the complete documentation index at: https://docs.byteport.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Move

> Relocate a file so it exists only in the destination location.

Relocates a file so it exists only in the destination location. Use [Copy](/api-reference/transfers/copy) if you want to keep the source in place.

### Body parameters

<ParamField body="from" type="string | string[]" required>
  Source location path.

  A valid file or folder path begins with the location, followed by a path
  relative to the root directory. To move multiple files, submit a string
  array. Regex supported.

  **Examples**

  * `"Production Bucket/archives/2026-04-21"`
  * `"Dropbox/*"`
</ParamField>

<ParamField body="to" type="string" required>
  Destination location path.
</ParamField>

### Example

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.byteport.com/move \
    -H "Authorization: Bearer bp_xxxxxxxxx" \
    -H "User-Agent: my-app/1.0" \
    -H "Content-Type: application/json" \
    -d '{
      "from": "Dropbox/inbox/*",
      "to":   "Production Bucket/inbox"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "trf_01HZ...",
    "status": "queued"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml POST /move
openapi: 3.1.0
info:
  title: Byteport API
  description: >-
    The Byteport API lets you move, share, and manage files across every storage
    location connected to your workspace through a single HTTP interface.
  version: 1.0.0
servers:
  - url: https://api.byteport.com
security:
  - bearerAuth: []
paths:
  /move:
    post:
      summary: Move
      description: >-
        Relocate one or more files or folders so they exist only in the
        destination location.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferRequest'
      responses:
        '200':
          description: Transfer accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransferResponse'
        '400':
          $ref: '#/components/responses/Error'
components:
  schemas:
    TransferRequest:
      type: object
      required:
        - from
        - to
      properties:
        from:
          description: >-
            Source location path. To target multiple files, submit a string
            array. Regex supported.
          oneOf:
            - type: string
            - type: array
              items:
                type: string
        to:
          type: string
          description: Destination location path.
    TransferResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier for the transfer.
        status:
          type: string
          enum:
            - queued
            - running
            - complete
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: integer
        message:
          type: string
  responses:
    Error:
      description: Unexpected error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````