Packs

Make a folder

A new folder for one tab's assets, optionally filing some in it straight away (any of another tab are listed in refused). A pack holds up to 100. Free.

POST/packs/{pack}/folders

Path parameters

packstringrequired

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

Body

namestringrequiredmax 40 characters

Its name.

kindstringrequired

The tab whose assets it holds.

Options: models, vehicles, mobs, blocks, items, armor, guis, hud, dialogs, icons, sounds, emotes, shaders

colorstringdefault "gray"

Its colour.

Options: gray, red, orange, yellow, green, cyan, blue, purple

assetsarray of object

Assets to file in it, as {kind, name} from the listing.

Response · 201

Made.

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.

folderobjectrequired

The new folder.

refusedarray of valuerequired

Assets 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.