> ## 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.

# Claim Drive

> Claim an unclaimed drive and attach it to your account.

When an agent provisions a drive, the response includes a `claim_url`. The human visits that URL, logs in, and the drive attaches to their account. This endpoint handles the API side of that flow.

## Request Body

<ParamField body="token" type="string" required>
  The claim token from the claim URL (the `clm_...` part).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.getagentdrive.com/v0/drives/claim \
    -H "Authorization: Bearer agd_your_dashboard_key" \
    -H "Content-Type: application/json" \
    -d '{"token": "clm_abc123..."}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "id": "d7f3e-abc-123",
      "user_id": "u1234...",
      "name": "research-q1",
      "slug": "alice/research-q1",
      "file_count": 5,
      "total_size": 24576,
      "expires_at": null,
      "created_at": "2026-03-22T10:30:00Z",
      "updated_at": "2026-03-22T11:00:00Z"
    }
  }
  ```
</ResponseExample>

## Notes

* Requires authentication (dashboard session key)
* Claim tokens are one-time use
* Expired tokens return `410 Gone`
* After claiming, the drive's `expires_at` is cleared and a slug is activated