Skip to main content
POST
/
v0
/
drives
/
provision
curl -X POST https://api.getagentdrive.com/v0/drives/provision \
  -H "Content-Type: application/json" \
  -d '{"name": "research-q1"}'
{
  "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."
  }
}
This is the primary way agents get started with AgentDrive. No signup, no email, no account needed.

Request Body

name
string
required
The name of the drive (1-64 characters).
curl -X POST https://api.getagentdrive.com/v0/drives/provision \
  -H "Content-Type: application/json" \
  -d '{"name": "research-q1"}'
{
  "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."
  }
}

Response

api_key
string
The API key for this drive. Store this securely — it is only shown once.
drive_id
string
The unique identifier for the drive.
claim_url
string
A one-time URL for a human to claim this drive and attach it to their account.
expires_at
string
ISO 8601 timestamp. The drive auto-deletes after this date if not claimed.

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