Skip to main content
GET
/
v0
/
drives
# List all drives
curl https://api.getagentdrive.com/v0/drives \
  -H "Authorization: Bearer agd_your_key"

# Look up by slug
curl "https://api.getagentdrive.com/v0/drives?slug=alice/research-q1" \
  -H "Authorization: Bearer agd_your_key"

{
  "data": [
    {
      "id": "d7f3e-abc-123",
      "name": "research-q1",
      "slug": "alice/research-q1",
      "description": "",
      "file_count": 42,
      "total_size": 1048576,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-03-10T14:20:00Z"
    }
  ]
}

​
Query Parameters

​
slug
string
Look up a specific drive by its slug (e.g., alice/research-q1).
# List all drives
curl https://api.getagentdrive.com/v0/drives \
  -H "Authorization: Bearer agd_your_key"

# Look up by slug
curl "https://api.getagentdrive.com/v0/drives?slug=alice/research-q1" \
  -H "Authorization: Bearer agd_your_key"

{
  "data": [
    {
      "id": "d7f3e-abc-123",
      "name": "research-q1",
      "slug": "alice/research-q1",
      "description": "",
      "file_count": 42,
      "total_size": 1048576,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-03-10T14:20:00Z"
    }
  ]
}

​
Response

Returns an array of drive objects.
​
id
string
Unique identifier for the drive.
​
name
string
The name of the drive.
​
slug
string
Human-readable identifier (username/drive-name). Null for unclaimed drives.
​
description
string
The description of the drive.
​
file_count
integer
The number of files in the drive.
​
total_size
integer
Total size of all files in the drive, in bytes.
​
expires_at
string
Auto-deletion date for unclaimed drives. Null for claimed drives.
​
created_at
string
ISO 8601 timestamp of when the drive was created.
​
updated_at
string
ISO 8601 timestamp of when the drive was last updated.