Docs
Add Folder
POST /drives/{eventId}/folders
POST
/drives/{eventId}/foldersRequired Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
| Event token | x-Event-Token | Optional | Run **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually. |
Creates a new folder in the drive within the specified partition and path.
Paths are ID-based. Use / to create the folder at the drive root. To nest inside an existing folder, pass that folder's fullPath (e.g., /{parentFolderId}).
Path Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| driveId | Guid | Required | The event ID. |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| partitionKey | Guid | Required | The partition to create the folder in (event ID, collaborator ID, or area ID). |
| name | string | Required | Display name for the folder. |
| description | string | Optional | Optional description. |
| path | string | Required | Parent path where the folder is created (e.g., `/` or `/{parentFolderId}`). |
Response
201 Created — No response body.
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Missing or invalid token. |
BAD_REQUEST | 400 | Empty name or invalid path. |