Packs

Read a Tooltip

A Tooltip whole: its spec (the design), the give command and the item components.

GET/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.

Response · 200

The Tooltip.

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

plan_required403

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

not_found404

No such pack, asset or job.