Brand Alignment: add to the narrative
POST /v1/brands/:brand_id/alignment/narrative
Access is limited to the brands permitted by your credential. Requires write:alignment. Workspace API keys and signed-in MCP sessions are supported.
Writes require an active workspace entitlement and an Idempotency-Key header. Support memberships cannot write.
Request body
Only the fields below are accepted. Identifiers in the URL cannot be overridden in the body.
| Field | Required | Description |
|---|---|---|
statement | Yes | One claim in one sentence, naming the brand, up to 300 characters. For avoid, write the claim itself, never its negation. |
direction | Yes | known for Should Say, avoid for Should Not Say. |
Response
The standard API envelope places the result in data, with request_id beside it at the top level.
Returns the new entry as position (id, statement, direction), slots (used and limit), applies_from and url. A narrative holds at most 12. The request takes 10 to 20 seconds, because Asky works out how it will read the statement, and counts toward a daily allowance. warning is present when the statement may be hard to measure, for example when it says two things. It is still added.