Packs
List a pack's assets
Page until nextCursor is null. An asset's id is also its job handle, so this is how you find the handle for something generated in an earlier run.
Every asset says what it is in type — block, item, item3d, gui, hud, dialog, icon, sound and so on — and that is the field to filter and branch on. kind is the file format it is stored as (texture, model, font, sound), which several types share: a block, an item sprite, a GUI, a HUD and a dialog are all textures. Some types are parts of another asset rather than assets of their own (block_face, model_texture, item_model).
Shaders, text effects, VFX, emotes and emote groups are listed too, after everything else, with kind set to the store they live in (shader, vfx, emote, emote_group) because they are documents rather than stored files: download one as JSON or as a picture with GET /packs/{pack}/assets/{kind}/{name} and its format. Their name is the id to send to POST /packs/{pack}/assets/{kind}/{name}/edit, and their id is a job handle like any other. The cursor pages across both parts as one list, so keep passing nextCursor until it is null.
/packs/{pack}/assetsPath parameters
packstringrequiredThe pack's slug, as returned by the packs endpoints.
Query parameters
typestringOnly assets of this type.
Options: model, vehicle, mob, block, block_face, model_texture, item, item_model, item3d, armor, armor3d, gui, hud, dialog, icon, rank_tag, sound, shader, text_effect, vfx, emote, emote_group
kindstringOnly assets stored in this file format, or in this store.
Options: texture, model, font, sound, shader, vfx, emote, emote_group
limitinteger1–200default 50How many to return.
cursorintegermin 0From the previous response's nextCursor.
Response · 200
One page of assets.
assetsarray of objectrequiredThis page of assets.
idstringrequiredStable id, and the job handle this asset was created under.
typestringrequiredWhat the asset is. Read this to tell assets apart.
Options: model, vehicle, mob, block, block_face, model_texture, item, item_model, item3d, armor, armor3d, gui, hud, dialog, icon, rank_tag, sound, shader, text_effect, vfx, emote, emote_group
kindstringrequiredThe file format it is stored as, which several types share. For a shader, text effect, VFX, emote or emote group, the store it lives in instead: those are documents rather than stored files.
Options: texture, model, font, sound, shader, vfx, emote, emote_group
namestringrequiredIts stored name within the pack. Treat it as an opaque key: type says what the asset is.
statusstringrequiredWhere the generation got to.
Options: generating, ready, error
displayNamestringThe label you gave it, if any.
promptstringWhat it was generated from.
errorstringWhy it failed. Null unless status is error.
sizeBytesintegerSize of the stored file. Null for the kinds with no file.
updatedAtstringrequiredISO 8601.
nextCursorstringPass as cursor for the next page. Null on the last page.
Error codes
Branch on error.code, never on the message.
invalid_request400Something in the body or query is wrong. message says what.
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.
plan_required403The key is valid, but its account's plan does not include the API.
not_found404No such pack, asset or job.