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

# List Drives

> List all drives in your account, or look up a drive by slug.

## Query Parameters

<ParamField query="slug" type="string">
  Look up a specific drive by its slug (e.g., `alice/research-q1`).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  # 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"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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"
      }
    ]
  }
  ```
</ResponseExample>

## Response

Returns an array of drive objects.

<ResponseField name="id" type="string">
  Unique identifier for the drive.
</ResponseField>

<ResponseField name="name" type="string">
  The name of the drive.
</ResponseField>

<ResponseField name="slug" type="string">
  Human-readable identifier (`username/drive-name`). Null for unclaimed drives.
</ResponseField>

<ResponseField name="description" type="string">
  The description of the drive.
</ResponseField>

<ResponseField name="file_count" type="integer">
  The number of files in the drive.
</ResponseField>

<ResponseField name="total_size" type="integer">
  Total size of all files in the drive, in bytes.
</ResponseField>

<ResponseField name="expires_at" type="string">
  Auto-deletion date for unclaimed drives. Null for claimed drives.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of when the drive was created.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp of when the drive was last updated.
</ResponseField>