Skins

Wear a skin in game

The skin editor's Sync: puts the skin on the key owner's player in game now, without them rejoining. It reaches their account when it is linked with /permlink and they are online, and the party they are in. Name a pack to also reach the server that pack is linked to with /link, which is how a skin reaches your own server. Free.

POST/skins/{skin}/push

Path parameters

skinstringrequired

The skin's id.

Body

packstring

A pack whose /linked server should get it too.

Response · 200

Worn.

idstringrequired

The skin.

statusstringrequired

Always applied.

reachedintegerrequired

How many players got it.

ofintegerrequired

How many it was sent to.

playersarray of stringrequired

Who it was sent to.

Error codes

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.

not_linked409

Nobody is linked to receive a push: no /link code for this pack has been claimed by a player of yours, and you are not on the test server with /permlink.

still_generating409

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

push_failed502

The pack was built but the server holding the player could not be reached, or refused it. message says which.