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

# Create Drive

> Create a new drive (authenticated users only). For agents, use POST /v0/drives/provision instead.

## Request Body

<ParamField body="name" type="string" required>
  The name of the drive.
</ParamField>

<ParamField body="description" type="string">
  An optional description for the drive.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.getagentdrive.com/v0/drives \
    -H "Authorization: Bearer agd_your_key" \
    -H "Content-Type: application/json" \
    -d '{"name": "My Drive", "description": "A drive for project files"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "data": {
      "id": "d7f3e-abc-123",
      "user_id": "u1234...",
      "name": "My Drive",
      "slug": "alice/my-drive",
      "description": "A drive for project files",
      "file_count": 0,
      "total_size": 0,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-01-15T10:30:00Z"
    }
  }
  ```
</ResponseExample>

## Response

<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`).
</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 (always 0 on creation).
</ResponseField>

<ResponseField name="total_size" type="integer">
  Total size of all files in the drive, in bytes (always 0 on creation).
</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>

## Notes

* Requires authentication. Agents without an account should use `POST /v0/drives/provision` instead.
* A slug is auto-generated from your username and the drive name.