Packs

Change a Tooltip

Renames it and/or replaces its spec, saved as the editor's Save saves. Send the spec from get_tooltip with your changes; anything out of range is brought back into it, and a field left out keeps its value. Free.

POST/packs/{pack}/tooltips/{tooltip}

Path parameters

packstringrequired

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

tooltipstringrequired

The Tooltip's id from the list.

Body

namestringmax 50 characters

A new name.

specobject

The design, in the shape get_tooltip answers.

Response · 200

Saved.

packstringrequired

The pack.

statusstring

ready, when it was designed or changed by AI.

tooltipobjectrequired

The Tooltip, with spec and components.

idstringrequired

Its id in the pack.

namestringrequired

Its name.

itemstringrequired

The vanilla item the give command hands out. The Tooltip itself shows on any item carrying its components.

widthintegerrequired

Its width in GUI pixels.

heightintegerrequired

Its height in GUI pixels.

blocksintegerrequired

How many blocks it has.

updatedAtstringrequired

ISO 8601.

giveCommandstringrequired

A /give for the item wearing it, once the pack is on the client (Minecraft 1.21.5+). Over 256 characters it has to run from the console or a command block.

componentsobject

The same item components as JSON, for ItemsAdder, Nexo or any plugin that takes them. Absent from the listing.

specobject

The design itself: width, padding, gap, frame, theme (colours), item, glint and blocks, top to bottom. Send it back changed to update_tooltip. Absent from the listing.

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.