Skins

Read a skin

One skin on the account.

GET/skins/{skin}

Path parameters

skinstringrequired

The skin's id.

The skin.

idstringrequired

The skin's id.

namestringrequired

Its name.

variantstringrequired

Arm width: wide (Steve) or slim (Alex).

Options: wide, slim

statusstringrequired

Where its generation got to. A skin made in the Studio is ready.

Options: generating, ready, error

errorstringrequired

Why the generation failed. Null otherwise.

promptstringrequired

What it was generated from, if it was.

createdAtstringrequired

ISO 8601.

updatedAtstringrequired

ISO 8601.

jobstringrequired

Its job handle, skin:<id>.

Branch on error.code, never on the message.

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 is on Starter. The API needs a paid plan.

not_found404

No such pack, asset or job.