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

# Move File

> Move a file to a new path, optionally to a different drive.

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the file to move.
</ParamField>

## Request Body

<ParamField body="destination_path" type="string" required>
  The new path for the file.
</ParamField>

<ParamField body="destination_drive_id" type="string">
  The ID of the drive to move the file to. Defaults to the current drive.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.getagentdrive.com/v0/files/file_xyz789/move \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "destination_path": "archive/2026/report.pdf"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "file_xyz789",
    "drive_id": "drv_abc123",
    "path": "archive/2026/report.pdf",
    "filename": "report.pdf",
    "mime_type": "application/pdf",
    "size": 24576,
    "content_hash": "sha256:abcdef1234567890",
    "content_preview": null,
    "tags": ["report", "2026"],
    "metadata": { "author": "Jane Doe" },
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-03-19T09:10:00Z"
  }
  ```
</ResponseExample>

## Response

Returns the updated file record. See [Get File](/api-reference/files/get) for the full response schema.