resourcepack.ai
DOCS

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.

GET/packs/{pack}/assets

Path parameters

packstringrequired

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

Query parameters

typestring

Only 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

kindstring

Only assets stored in this file format, or in this store.

Options: texture, model, font, sound, shader, vfx, emote, emote_group

limitinteger1–200default 50

How many to return.

cursorintegermin 0

From the previous response's nextCursor.

Response · 200

One page of assets.

assetsarray of objectrequired

This page of assets.

idstringrequired

Stable id, and the job handle this asset was created under.

typestringrequired

What 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

kindstringrequired

The 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

namestringrequired

Its stored name within the pack. Treat it as an opaque key: type says what the asset is.

statusstringrequired

Where the generation got to.

Options: generating, ready, error

displayNamestring

The label you gave it, if any.

promptstring

What it was generated from.

errorstring

Why it failed. Null unless status is error.

sizeBytesinteger

Size of the stored file. Null for the kinds with no file.

updatedAtstringrequired

ISO 8601.

nextCursorstring

Pass as cursor for the next page. Null on the last page.

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.

plan_required403

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

not_found404

No such pack, asset or job.