Skip to main content
PUT
Write a new revision of a posture (forward-only)

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Headers

Idempotency-Key
string
required

Client-supplied idempotency token (required). Replays within 24 hours return the stored result; reusing a key with a different body returns 409. See ADR-023.

Path Parameters

posture_id
string
required

Posture ID (tp-{8-hex}).

Pattern: ^tp-[a-z0-9-]{1,64}$

Body

application/json
body
object
required

New trust posture body (PostureBody v1.0) to persist as the next revision; replaces the prior body in full.

change_note
string

Optional note describing this revision, recorded in the posture's revision history.

Response

Updated posture with new revision.

Versioned posture body. Immutable by handler discipline (forward-only). Matches revisionForResponse() exactly.

revision_id
string
required
posture_id
string
required
revision_no
integer
required
Required range: x >= 1
body
object
required

The versioned posture body (PostureBody shape; older revisions may predate the v1.0 schema).

change_summary
string | null
required
authored_by
string | null
required
authored_at
string<date-time> | null
required