Skip to main content
POST
/
v0
/
folders
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/"
  }'

{
  "drive_id": "drv_abc123",
  "path": "documents/reports/2026/",
  "created_at": "2026-03-19T10:00:00Z"
}

​
Request Body

​
drive_id
string
required
The ID of the drive to create the folder in.
​
path
string
required
The path of the folder to create. Must end with /. Parent folders are created automatically if they do not exist.
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/"
  }'

{
  "drive_id": "drv_abc123",
  "path": "documents/reports/2026/",
  "created_at": "2026-03-19T10:00:00Z"
}

​
Response

​
drive_id
string
The ID of the drive the folder belongs to.
​
path
string
The full path of the created folder.
​
created_at
string
ISO 8601 timestamp of when the folder was created.