manage brand kit
The brand kits of this workspace: direction in blocks, colors, fonts, logos and reference files each with a line, the words it spells its own way (corrected in transcripts), and pins (caption templates, text styles, skills, timelines, canvases, graphics) with a note on when each applies. Called with nothing it reads the active kit and lists the kits; kit names another; kits are made, renamed, activated and deleted here. colors and fonts replace the whole list; a block a user wrote is theirs. Nothing invented: facts come from the guidelines in the library, the logos, then the user; a color read by eye is an estimate; an empty section stays empty. delete_kit takes the word “delete”. Free.
Authorizations
An API key (es_live_…) from Settings, under API keys, or an OAuth access token.
Headers
Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.
The workspace this one call acts in, when it is not the key's own.
Body
A block of written direction to add: voice, rules, what the brand does and does not do. Blocks the user wrote are theirs; add one rather than rewriting.
8000The id of a context block to remove, as the kit reads it back.
80The whole palette, replacing what is there.
24The whole type list, replacing what is there.
12Pin one thing to the kit. A caption template or skill already pinned has its note refreshed instead of a second pin.
Change what a pin says without pinning it again.
The id of a pin to remove, as the kit reads it back.
80Library files the brand is made of, 50 a call. A bare ref links as a reference; naming a role or a name on a ref already linked corrects it in place.
50An item ref, item id, or the job id that made it.
Linked items that are no longer the identity.
50An item ref, item id, or the job id that made it.
Rewrite one context block, by the id the kit reads back. For a block you added; a user's block is theirs to change.
Which kit, by name or id, when the workspace holds more than one. Left out, the workspace's active kit.
80Make a new kit by this name and work in it for the rest of the call. The free plan holds one kit; the answer says so when there is no room.
80A new name for the kit this call is on.
80Make the kit this call is on the workspace's active one, the one read when no kit is named.
The word "delete", to delete the kit this call is on with its colors, fonts, context, pins and links. There is no way back and the answer says what went; the files stay in the library. Only when the user asked for it.
"delete"Names this workspace spells its own way, corrected in transcripts after they come back. One word, a name or a piece of jargon, with the spellings it was heard as. Shared by every kit. A one-letter word, or a heard_as under three letters, is refused.
Optional: one sentence shown to the user beside this action.
600
