Skip to main content
PUT
/
postures
/
{posture_id}
Write a new revision of a posture (forward-only)
curl --request PUT \
  --url https://api.mnemom.ai/v1/postures/{posture_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "body": {},
  "change_note": "<string>"
}
'
{
  "revision_id": "<string>",
  "posture_id": "<string>",
  "revision_number": 2,
  "body": {},
  "created_at": "2023-11-07T05:31:56Z",
  "change_note": "<string>",
  "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

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
​
change_note
string

Response

Updated posture with new revision.

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

​
revision_id
string
required
Pattern: ^tpr-[0-9a-f]{8}$
​
posture_id
string
required
​
revision_number
integer
required
Required range: x >= 1
​
body
object
required

Composition inputs: alignment_card, protection_card, integrity, autonomy, etc.

​
created_at
string<date-time>
required
​
change_note
string | null
​
created_by
string<uuid> | null