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

> Create a new folder in a drive. Parent folders are created automatically.

## Request Body

<ParamField body="drive_id" type="string" required>
  The ID of the drive to create the folder in.
</ParamField>

<ParamField body="path" type="string" required>
  The path of the folder to create. Must end with `/`. Parent folders are created automatically if they do not exist.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.getagentdrive.com/v0/folders \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "drive_id": "drv_abc123",
      "path": "documents/reports/2026/"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "drive_id": "drv_abc123",
    "path": "documents/reports/2026/",
    "created_at": "2026-03-19T10:00:00Z"
  }
  ```
</ResponseExample>

## Response

<ResponseField name="drive_id" type="string">
  The ID of the drive the folder belongs to.
</ResponseField>

<ResponseField name="path" type="string">
  The full path of the created folder.
</ResponseField>

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