Packs

Change a pack's settings

Its name, its description (the line Minecraft shows under the name in the pack list) and whose AI Credits a generation in it spends, as the Studio's pack settings change them. Send only what changes; an empty description clears it.

Only the pack's owner, or an admin of its team, may: the credit source decides whose balance every collaborator's generations draw on. The slug never changes, so nothing that names the pack breaks.

POST/packs/{pack}

Path parameters

packstringrequired

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

Body

namestringmax 100 characters

The display name.

descriptionstring

What Minecraft shows under the name. Empty clears it.

creditSourcestring

Whose credits a generation spends: the pack owner's, or whoever asked for it. Ignored on a team pack, which the team pays for.

Options: owner, prompter

Response · 200

Saved. The pack as it now stands.

packobjectrequired

The pack.

slugstringrequired

The pack's id. Every other path takes this.

namestringrequired

Its display name.

minecraftVersionstringrequired

The version the pack is authored against.

rolestringrequired

Whether this key's owner owns the pack or was added to it.

Options: owner, collaborator

descriptionstringrequired

What Minecraft shows under the pack's name. Null when none is set.

creditSourcestringrequired

Whose AI Credits a generation in it spends: the owner's, or whoever asked for it. A team pack is paid by the team either way.

Options: owner, prompter

hasIconbooleanrequired

Whether the pack has an icon of its own.

createdAtstringrequired

ISO 8601.

updatedAtstringrequired

ISO 8601.

assetCountsobjectrequired

How much the pack holds, by kind.

texturesintegerrequired

Block textures, item sprites and GUI sheets.

modelsintegerrequired

3D models.

iconsintegerrequired

Font glyphs.

soundsintegerrequired

Sound events.

minVersionstringrequired

Oldest Minecraft version this pack's contents will load on.

Error codes

Branch on error.code, never on the message.

invalid_json400

The request body wasn't a JSON object.

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.

forbidden403

Valid key, but not permitted to do this in this pack.

plan_required403

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

not_found404

No such pack, asset or job.