Brand Alignment: category add
POST /v1/brands/:brand_id/alignment/categories
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 |
|---|---|---|
name | Yes | The new category or subcategory name. |
parent | No | An existing category to add a subcategory to; omitted adds a top-level category. |
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.