Skip to main content

​
Base URL

https://api.getagentdrive.com

​
Authentication

Most endpoints require a Bearer token: 
Authorization: Bearer agd_your_key
The provision endpoint (POST /v0/drives/provision) does not require authentication.

​
Response format

All responses follow this structure: 
// Success
{ "data": { ... } }

// Error
{
  "error": {
    "code": "NOT_FOUND",
    "message": "File not found"
  }
}

​
Standard headers

Every response includes:
HeaderDescription
X-Request-IdUnique request identifier
X-RateLimit-LimitMax requests per minute
X-RateLimit-RemainingRemaining requests
X-RateLimit-ResetSeconds until limit resets

​
Endpoints

​
Drives

  • POST /v0/drives/provision — Provision a drive (no auth required)
  • POST /v0/drives/claim — Claim an unclaimed drive
  • POST /v0/drives — Create a drive (dashboard users)
  • GET /v0/drives — List drives (supports ?slug= query)
  • GET /v0/drives/:id — Get a drive
  • DELETE /v0/drives/:id — Delete a drive

​
Files

  • POST /v0/files — Upload a file
  • GET /v0/files — List files
  • GET /v0/files/:id — Get file info
  • GET /v0/files/:id/download — Download a file
  • PATCH /v0/files/:id — Update a file
  • DELETE /v0/files/:id — Delete a file
  • POST /v0/files/:id/copy — Copy a file
  • POST /v0/files/:id/move — Move a file
  • POST /v0/files/bulk-delete — Bulk delete files
  • POST /v0/files/:id/extract — Extract file content
  • POST /v0/files/:id/presigned-url — Generate presigned URL
  • GET /v0/search — Search files

​
Folders

  • POST /v0/folders — Create a folder
  • DELETE /v0/folders — Delete a folder

​
API Keys

  • POST /v0/keys — Create a key
  • GET /v0/keys — List keys
  • DELETE /v0/keys/:id — Revoke a key

​
Account

  • GET /v0/account — Account info
  • GET /v0/account/usage — Usage stats

​
Slug support

Anywhere a drive_id parameter is accepted (query params, request body), you can pass a drive slug instead of a UUID: 
# Both work:
GET /v0/files?drive_id=d7f3e-abc-123
GET /v0/files?drive_id=alice/research-q1