Packs
Download an asset file
The asset's own bytes, with the matching content type: PNG for textures and icons, JSON for models, Ogg Vorbis for sounds.
The path takes an asset's kind and name exactly as the asset listing reports them — texture/item:rusted_key for an item sprite, texture/gui:shop_menu for a GUI, vfx/frost_burst for a VFX — so copy both from there rather than building them from its type.
A shader, text effect, VFX, emote or emote group is a document rather than stored bytes, and format says how to have it. file (the default) is that document as JSON: a VFX's recipe (what its page's Download recipe saves), a shader object, an emote's keyframes, an emote group's parts. picture is a PNG drawn on the server: a VFX as six moments across its timeline, left to right, and a 3D shader object or a text effect as its card. animation is a GIF of a VFX or a text effect playing. A 2D shader overlay and an emote have no picture on the server (the browser draws them) and answer no_file for one. A stored asset always answers its own file, whatever format says.
Asking before it's ready answers 409 rather than handing back the placeholder that sits there while it generates — a blank PNG that looked like a result is the one genuinely misleading answer available here.
/packs/{pack}/assets/{kind}/{name}Path parameters
packstringrequiredThe pack's slug, as returned by the packs endpoints.
kindstringrequiredThe asset's kind from the listing.
Options: texture, model, font, sound, shader, vfx, emote, emote_group
namestringrequiredThe asset's stored name, from the listing.
Query parameters
formatstringdefault "file"For a shader, text effect, VFX, emote or emote group: its JSON (file), a PNG of it (picture) or a GIF of it moving (animation). Ignored for every other kind.
Options: file, picture, animation
Response · 200
The file.
Error codes
Branch on error.code, never on the message.
invalid_request400Something in the body or query is wrong. message says what.
no_file400That asset has nothing in the format asked for: a 2D shader overlay and an emote have no picture on the server, and only a VFX and a text effect have an animation. message says what there is.
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.
generation_failed409That asset's generation failed. Its job carries the reason.
still_generating409The asset exists but isn't finished. Poll its job until it's ready.