Brand Alignment: fact edit
PATCH /v1/brands/:brand_id/alignment/facts/:fact_id
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. Fact slots and scanned-fact editing limits also apply.
Asky manages the monitoring questions. Responses include fact results and answer evidence without exposing generated question text.
Request body
Only the fields below are accepted. Brand and fact identifiers in the URL cannot be overridden in the body.
| Field | Required | Description |
|---|---|---|
text | No | The fact, one plain statement in the brand’s own words, up to 300 characters. |
category | No | Move the fact to this category; a new name creates it. |
subcategory | No | The subcategory inside its category; an empty string clears it. |
countries | No | Replace the complete list of countries it is checked in. |
language | No | Ask it in this language from now on, in every one of its countries. |
product_id | No | The product or service it is about; null makes it brand-wide. |
Response
The standard API envelope places the program, overview, fact detail or write confirmation in data, with request metadata in meta.
Scan identifiers come from the program endpoint. Historical scans keep their original evidence. A setup edit applies to future scans.