Brand Alignment: suggestions run
POST /v1/brands/:brand_id/alignment/suggestions/run
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 |
|---|---|---|
focus | No | Categories or themes to draft facts for; omitted drafts for the thinnest categories. |
countries | No | Where the suggested facts should be checked. Default: the program’s current locations. |
language | No | ISO 639-1 code of the language the fact is asked in (en, de, nl, …). |
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.