Skip to main content
PUT
Publish or replace the alignment manifest

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Headers

Idempotency-Key
string
required

Client-supplied idempotency token. Replays within 24 hours return the stored result. See ADR-023.

Required string length: 1 - 128
If-Match
string

Optional optimistic-concurrency token. Pass the ETag from a recent GET ("sha256:<hex64>" shape) to make the write conditional: a stale ETag returns 412 Precondition Failed, a malformed one 400. Omit it to publish unconditionally.

Pattern: ^"sha256:[0-9a-f]{64}"$

Path Parameters

agent_id
string
required

Agent identifier (e.g. smolt-abc123)

Body

Unified alignment card (ADR-008). Authored in YAML or JSON; composed server-side with platform defaults, org template, and active exemptions before storage.

card_version
string
required

Card schema version (e.g. 0.5.0).

agent_id
string
required

Target agent id. On PUT, server overwrites to match the URL path.

values
object
required
autonomy
object
required
audit
object
required
card_id
string

Card row id. Server-assigned on PUT (ac-{uuid}).

issued_at
string<date-time>
expires_at
string<date-time> | null
principal
object
conscience
object
integrity
object
capabilities
object
enforcement
object
extensions
object
_composition
object

System-managed block describing which scope sources merged into the canonical card. Only returned when ?include_composition=true.

Response

Composed canonical card after the write.

Unified alignment card (ADR-008). Authored in YAML or JSON; composed server-side with platform defaults, org template, and active exemptions before storage.

card_version
string
required

Card schema version (e.g. 0.5.0).

agent_id
string
required

Target agent id. On PUT, server overwrites to match the URL path.

values
object
required
autonomy
object
required
audit
object
required
card_id
string

Card row id. Server-assigned on PUT (ac-{uuid}).

issued_at
string<date-time>
expires_at
string<date-time> | null
principal
object
conscience
object
integrity
object
capabilities
object
enforcement
object
extensions
object
_composition
object

System-managed block describing which scope sources merged into the canonical card. Only returned when ?include_composition=true.