brand_kit

Call brand_kit.set_adherence

'keep the brand loose for this post', 'stick to our brand exactly from now on' — set how closely drafts follow this workspace's brand kit: tight (exactly), balanced (mostly) or loose (as a reference), for one piece named by its title, or as the brand's default for every draft that follows. It answers in two calls: without confirmation_id it proposes and says what would change; the same call again with that confirmation_id, on a member's own API key, applies exactly that. The brand's facts and banned words hold at every level. Not for changing what the kit says — that is brand_kit.suggest.

Every result names the workspace it ran in. Say which workspace the answer is about. When the account has more than one workspace and none is selected, this tool refuses with workspace_ambiguous and lists the choices — offer them, never pick one.

post/api/v1/tools/brand_kit.set_adherence

Request

  • Base URL: https://app.goosybear.ai
  • URL: https://app.goosybear.ai/api/v1/tools/brand_kit.set_adherence
  • Auth: HTTP bearer

Headers

x-request-idstring

Your own id for this request, echoed back and recorded on the audit trail. 1–128 characters from A–Z a–z 0–9 . _ : -, starting with a letter or digit; anything else is replaced by a generated id.

Request body

level'tight' | 'balanced' | 'loose' required

tight = stick to the brand exactly; balanced = mostly; loose = use it as a reference only (the facts still hold).

target'turn' | 'piece' | 'kit' required

turn = what the member just said about THIS piece in chat; piece = the piece's own setting; kit = the brand's default for everything.

piece_titlestring

For turn and piece, when no piece is open in this conversation: the piece's title, in the member's words.

confirmation_idstring uuid
workspacestring

Which workspace to run in — its slug. Omit to use your default. With more than one reachable workspace and no default, the call is refused and the choices are listed.

Response

The call was admitted and dispatched. ok says whether the tool succeeded — a refusal the tool itself produced is still a 200, exactly as it is a successful JSON-RPC result over MCP.

OR

Changes

No recorded changes to this operation across all 6 revisions of this API.