Packs
Delete a folder
Removes a folder. What it held goes back to the top of the pack; no asset is deleted.
/packs/{pack}/folders/{folder}/deletePath parameters
packstringrequiredThe pack's slug, as returned by the packs endpoints.
folderstringrequiredThe folder's id from the folder list.
Response · 200
Deleted. The folders that remain.
packstringrequiredThe pack.
foldersarray of valuerequiredThe folders, as {id, name, color, kind, createdAt}.
assignmentsobjectrequiredAsset (<type>:<id>) to folder id. An asset in no folder has no entry.
Error codes
Branch on error.code, never on the message.
invalid_api_key401The key isn't one of ours, or it has been revoked.
missing_api_key401No Authorization: Bearer header was sent.
wrong_key_kind401An MCP key sent to the REST API, or an API key sent to the MCP server. Each only opens its own.
account_suspended403The account is suspended, so its keys open nothing. message says until when, if the suspension has an end date.
forbidden403Valid key, but not permitted to do this in this pack.
plan_required403The key is valid, but its account's plan does not include the API.
not_found404No such pack, asset or job.