Method
POST /v1/gallery/folders
Body Parameters
Headers
string
Bearer token (e.g.
Authorization: Bearer YOUR_API_KEY)string
application/jsonRequest 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"
}'
await fetch("https://api.voyantcloud.com/v1/gallery/folders", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOYANT_API_KEY}`,
"content-type": "application/json",
},
body: JSON.stringify({
name: "Campaigns",
parentFolderId: "11111111-1111-1111-1111-111111111111",
}),
})
import os, requests
payload = {
"name": "Campaigns",
"parentFolderId": "11111111-1111-1111-1111-111111111111",
}
resp = requests.post(
"https://api.voyantcloud.com/v1/gallery/folders",
headers={
"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}",
"content-type": "application/json",
},
json=payload,
)
folder = resp.json()["data"]
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.