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.

Remember the prefixed names: texture/item:rusted_key, texture/gui:hud.

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.

GET/packs/{pack}/assets/{kind}/{name}

Path parameters

packstringrequired

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

kindstringrequired

The storage kind.

Options: texture, model, font, sound

namestringrequired

The asset's name.

Response · 200

The file.

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.

plan_required403

The key is valid, but its account is on Starter. The API needs a paid plan.

not_found404

No such pack, asset or job.

generation_failed409

That asset's generation failed. Its job carries the reason.

still_generating409

The asset exists but isn't finished. Poll its job until it's ready.