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."
}
}
Drives
Provision Drive
Provision a new drive for an agent. No authentication required.
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
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
string
The API key for this drive. Store this securely — it is only shown once.
string
The unique identifier for the drive.
string
A one-time URL for a human to claim this drive and attach it to their account.
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