Accepts YAML (text/yaml, application/yaml) or JSON (application/json). Body is the full UnifiedAlignmentCard; server-side composition merges it with platform defaults, the org alignment template, and any active exemptions, then stores the canonical composed card. Requires Idempotency-Key — replays within 24 hours return the stored result. Body cap: 128 KiB. See ADR-008 and ADR-023.
Publishes a new alignment card for an agent. The handler validates the card against the AAP schema, composes it with the Platform and Org scopes, and atomically writes the canonical row. This is the canonical UC-4 endpoint that replaced the legacyDocumentation Index
Fetch the complete documentation index at: https://docs.mnemom.ai/llms.txt
Use this file to discover all available pages before exploring further.
PATCH /v1/agents/{id}/card, PUT /v1/agents/{id}/policy, and PUT /v1/agents/{id}/cfd/config endpoints (all removed 2026-04-15 — see Unified cards overview).
422 Idempotency-Key conflict.
Content-Type | Body |
|---|---|
text/yaml | Raw YAML card document |
application/yaml | Raw YAML card document |
application/json | Raw card object, or { "card_yaml": "<yaml string>" }, or { "card_json": {...} } |
values, autonomy, and commitments blocks at minimum. See the alignment card schema for full requirements.
governance_audit_log row before responding (synchronous; failure aborts).alignment_card.updated webhook event (see Webhooks guide).Supabase JWT token in Authorization: Bearer header
Replay key (24 h window).
Agent identifier (e.g. smolt-abc123)
UC-4 unified alignment card (ADR-008). Authored in YAML or JSON; composed server-side with platform defaults, org template, and active exemptions before storage.
Card schema version (e.g. 0.5.0).
Target agent id. On PUT, server overwrites to match the URL path.
Card row id. Server-assigned on PUT (ac-{uuid}).
System-managed block describing which scope sources merged into the canonical card. Only returned when ?include_composition=true.
Card accepted, composed, and stored. Body is the post-composition canonical card.
UC-4 unified alignment card (ADR-008). Authored in YAML or JSON; composed server-side with platform defaults, org template, and active exemptions before storage.
Card schema version (e.g. 0.5.0).
Target agent id. On PUT, server overwrites to match the URL path.
Card row id. Server-assigned on PUT (ac-{uuid}).
System-managed block describing which scope sources merged into the canonical card. Only returned when ?include_composition=true.