Create Folder

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"
}

POST

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

string

required

The ID of the drive to create the folder in.

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

string

The ID of the drive the folder belongs to.

string

The full path of the created folder.

string

ISO 8601 timestamp of when the folder was created.

Create Presigned URL Delete Folder

API Reference

Drives

Files

Folders

API Keys

Account

Request Body

Response

​Request Body

​Response

Request Body

Response