Folders

Organize files hierarchically inside a container.

Endpoints

Method	Path	Description	Permission
POST	/api/v1/containers/{container}/folders	Create a folder	files.write
GET	/api/v1/containers/{container}/folders/{folderId}/children	List a folder's children	files.read
PATCH	/api/v1/containers/{container}/files/{folderId}	Rename a folder	files.write
DELETE	/api/v1/containers/{container}/files/{folderId}	Delete a folder (recursive)	files.delete

Create a folder

curl -X POST "https://storage.devd.org/api/v1/containers/contracts/folders" \
  -H "X-API-Key: sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "2026", "parentFolderId": "folder_XXXX"}'

# Or create relative to a path:
  -d '{"name": "q3", "path": "2026/reports"}'

Omit both parentFolderId and path to create at the container root. Creating a folder that already exists returns ITEM_ALREADY_EXISTS (409).

List children

curl "https://storage.devd.org/api/v1/containers/contracts/folders/folder_XXXX/children?limit=100" \
  -H "X-API-Key: sk_live_YOUR_KEY"

Accepts the same limit / cursor / type / name / sort / order query parameters as the items listing.