Skip to Content
APIEndpointsNarrative add

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.

FieldRequiredDescription
statementYesOne claim in one sentence, naming the brand, up to 300 characters. For avoid, write the claim itself, never its negation.
directionYesknown 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.

Last updated on