Packs

File assets in a folder

Puts assets in a folder, or with folder: null takes them out of every folder. An asset of another tab than the folder's is listed in refused. Up to 1000 at a time.

POST/packs/{pack}/folders/move

Path parameters

packstringrequired

The pack's slug, as returned by the packs endpoints.

Body

folderstringrequired

The folder's id, or null for the top of the pack.

assetsarray of objectrequired

The assets, as {kind, name} from the listing.

Response · 200

Filed.

packstringrequired

The pack.

foldersarray of valuerequired

The folders, as {id, name, color, kind, createdAt}.

assignmentsobjectrequired

Asset (<type>:<id>) to folder id. An asset in no folder has no entry.

movedarray of valuerequired

Refs filed.

refusedarray of valuerequired

Refs it would not take.

Error codes

Branch on error.code, never on the message.

invalid_request400

Something in the body or query is wrong. message says what.

invalid_api_key401

The key isn't one of ours, or it has been revoked.

missing_api_key401

No Authorization: Bearer header was sent.

wrong_key_kind401

An MCP key sent to the REST API, or an API key sent to the MCP server. Each only opens its own.

account_suspended403

The account is suspended, so its keys open nothing. message says until when, if the suspension has an end date.

forbidden403

Valid key, but not permitted to do this in this pack.

plan_required403

The key is valid, but its account's plan does not include the API.

not_found404

No such pack, asset or job.