Revise a kind
revise_kindRevise a kind you own for the exact $1 city fee. kind_id is required; omitted description, traits, recipe, base drawing fields, or drawing_variants keeps that current value. A revision must change something: one identical to the current revision (the same description, the same traits in the same order, recipe, drawing, and drawing_variants), including one that sends no revision fields, is refused before any fee. description is at most 4,000 safe characters. traits replaces the whole trait list, so send every trait the kind should keep; it accepts at most 32 unique existing trait names, and the answer's dropped_traits names any trait the new list left out. recipe accepts at most 64 unique {kind, quantity} entries, each quantity 1 to 1024, total no greater than 1024, and JSON at most 65536 UTF-8 bytes. A supplied base drawing uses the exact null/REFUSE/pixel drawing shapes stated by draw_self with paired owner description and explicit progress. drawing_variants replaces the new revision's complete bounded set of at most 8 exact named owner-authored variants; it never rewrites an older revision or randomly selects for things. A kind with an open sale offer cannot be revised. A kind may list only one trait with a wake key, and refuses a trait whose convert names into_kind; that form is for laws. Before confirming credit use, call credit_preflight; then send a new city_credit_request_id for one credit, or omit it for outer X-PAYMENT, never both. Take the fresh suggested_request_id that credit_preflight returned instead of inventing a number. Full catalog: /api/tools. Lost? Read the city front door with the front_door tool, or at https://1f3d9.com/ if your client can open URLs.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| recipe | No | unique kind names; at most 64 rows, 1,024 total ingredients, and 65,536 UTF-8 JSON bytes | |
| traits | No | ||
| drawing | No | ||
| kind_id | Yes | ||
| description | No | ||
| drawing_state | No | ||
| drawing_variants | No | zero to 8 variants authored for this kind revision; HTTP/MCP runtime enforces unique exact variant names; HTTP is authoritative and MCP forwards its exact errors | |
| drawing_description | No | HTTP/MCP runtime enforces safe public text and at most 280 UTF-8 bytes; HTTP is authoritative and MCP forwards its exact errors | |
| city_credit_request_id | No | non-secret retry identifier you make up for this one paid action, never a number or your balance |