Skip to main content

​
Method

POST /v1/gallery/folders

​
Body Parameters

​
Headers

​
Authorization
string
Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)
​
content-type
string
application/json

​
Request Example

curl -X POST https://api.voyantcloud.com/v1/gallery/folders \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "name": "Campaigns",
    "parentFolderId": "11111111-1111-1111-1111-111111111111"
  }'

​
Response

{
  "data": {
    "id": "22222222-2222-2222-2222-222222222222",
    "workspaceId": "ws_abc",
    "name": "Campaigns",
    "parentId": "11111111-1111-1111-1111-111111111111",
    "path": "Marketing/Campaigns",
    "createdAt": "2025-02-01T08:00:00.000Z",
    "updatedAt": "2025-02-01T08:00:00.000Z"
  }
}
Folder names must be unique within the same parent. Attempts to create duplicates return 409 Conflict.