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

# Provision Drive

> Provision a new drive for an agent. No authentication required.

This is the primary way agents get started with AgentDrive. No signup, no email, no account needed.

## Request Body

<ParamField body="name" type="string" required>
  The name of the drive (1-64 characters).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.getagentdrive.com/v0/drives/provision \
    -H "Content-Type: application/json" \
    -d '{"name": "research-q1"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "api_key": "agd_3473f3e1b29e406fa79edf82627305ce",
      "key_id": "a1b2c3d4-...",
      "drive_id": "d7f3e-abc-123",
      "drive_name": "research-q1",
      "claim_url": "https://getagentdrive.com/claim/clm_xyz...",
      "expires_at": "2026-04-21T10:30:00Z",
      "message": "Drive provisioned. Share the claim_url with a human to attach this drive to their account."
    }
  }
  ```
</ResponseExample>

## Response

<ResponseField name="api_key" type="string">
  The API key for this drive. Store this securely — it is only shown once.
</ResponseField>

<ResponseField name="drive_id" type="string">
  The unique identifier for the drive.
</ResponseField>

<ResponseField name="claim_url" type="string">
  A one-time URL for a human to claim this drive and attach it to their account.
</ResponseField>

<ResponseField name="expires_at" type="string">
  ISO 8601 timestamp. The drive auto-deletes after this date if not claimed.
</ResponseField>

## Notes

* No authentication required
* Rate limited to 10 provisions per IP per hour
* Unclaimed drives auto-delete after 30 days
* Unclaimed drives are limited to 100 MB storage