Generating

Change a Tooltip with AI

The editor's Edit with AI: changes what instruction asks (icy blue colours, add a lifesteal stat) and keeps the rest, then saves it before answering. 5 credits, flat, given back if it fails.

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

Path parameters

packstringrequired

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

tooltipstringrequired

The Tooltip's id from the list.

Body

instructionstringrequiredmax 300 characters

What to change.

Response · 200

Changed and 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_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.

insufficient_credits402

Not enough AI Credits to run this. Nothing was started or charged.

account_suspended403

The account is suspended, so its keys open nothing. message says until when, if the suspension has an end date.

asset_limit_reached403

The pack is at its asset limit.

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.