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": {
"posture_schema_version": "v1.0",
"sideband": {
"coherence": {
"enabled": true,
"cadence_seconds": 2,
"fire_on": {
"pairwise_governance_floor_below": 0.5,
"conflict_edge_count_exceeds": 1,
"outlier_agents_count_exceeds": 1
}
},
"fault_line": {
"enabled": true,
"cadence_seconds": 2,
"use_reputation_scores": true
},
"fleet": {
"enabled": true,
"cadence_seconds": 2,
"patterns": {
"outliers": true,
"cluster_partition": true,
"min_pair_score_below": 0.5
}
}
},
"fleet_identification": {
"by": "team_membership"
},
"fan_out": {
"rule": "per_named_affected_agent"
}
},
"change_note": "<string>"
}
'import requests
url = "https://api.mnemom.ai/v1/postures/{posture_id}"
payload = {
"body": {
"posture_schema_version": "v1.0",
"sideband": {
"coherence": {
"enabled": True,
"cadence_seconds": 2,
"fire_on": {
"pairwise_governance_floor_below": 0.5,
"conflict_edge_count_exceeds": 1,
"outlier_agents_count_exceeds": 1
}
},
"fault_line": {
"enabled": True,
"cadence_seconds": 2,
"use_reputation_scores": True
},
"fleet": {
"enabled": True,
"cadence_seconds": 2,
"patterns": {
"outliers": True,
"cluster_partition": True,
"min_pair_score_below": 0.5
}
}
},
"fleet_identification": { "by": "team_membership" },
"fan_out": { "rule": "per_named_affected_agent" }
},
"change_note": "<string>"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
body: JSON.stringify({
posture_schema_version: 'v1.0',
sideband: {
coherence: {
enabled: true,
cadence_seconds: 2,
fire_on: {
pairwise_governance_floor_below: 0.5,
conflict_edge_count_exceeds: 1,
outlier_agents_count_exceeds: 1
}
},
fault_line: {enabled: true, cadence_seconds: 2, use_reputation_scores: true},
fleet: {
enabled: true,
cadence_seconds: 2,
patterns: {outliers: true, cluster_partition: true, min_pair_score_below: 0.5}
}
},
fleet_identification: {by: 'team_membership'},
fan_out: {rule: 'per_named_affected_agent'}
}),
change_note: '<string>'
})
};
fetch('https://api.mnemom.ai/v1/postures/{posture_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mnemom.ai/v1/postures/{posture_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'body' => [
'posture_schema_version' => 'v1.0',
'sideband' => [
'coherence' => [
'enabled' => true,
'cadence_seconds' => 2,
'fire_on' => [
'pairwise_governance_floor_below' => 0.5,
'conflict_edge_count_exceeds' => 1,
'outlier_agents_count_exceeds' => 1
]
],
'fault_line' => [
'enabled' => true,
'cadence_seconds' => 2,
'use_reputation_scores' => true
],
'fleet' => [
'enabled' => true,
'cadence_seconds' => 2,
'patterns' => [
'outliers' => true,
'cluster_partition' => true,
'min_pair_score_below' => 0.5
]
]
],
'fleet_identification' => [
'by' => 'team_membership'
],
'fan_out' => [
'rule' => 'per_named_affected_agent'
]
],
'change_note' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mnemom.ai/v1/postures/{posture_id}"
payload := strings.NewReader("{\n \"body\": {\n \"posture_schema_version\": \"v1.0\",\n \"sideband\": {\n \"coherence\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"fire_on\": {\n \"pairwise_governance_floor_below\": 0.5,\n \"conflict_edge_count_exceeds\": 1,\n \"outlier_agents_count_exceeds\": 1\n }\n },\n \"fault_line\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"use_reputation_scores\": true\n },\n \"fleet\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"patterns\": {\n \"outliers\": true,\n \"cluster_partition\": true,\n \"min_pair_score_below\": 0.5\n }\n }\n },\n \"fleet_identification\": {\n \"by\": \"team_membership\"\n },\n \"fan_out\": {\n \"rule\": \"per_named_affected_agent\"\n }\n },\n \"change_note\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.mnemom.ai/v1/postures/{posture_id}")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"body\": {\n \"posture_schema_version\": \"v1.0\",\n \"sideband\": {\n \"coherence\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"fire_on\": {\n \"pairwise_governance_floor_below\": 0.5,\n \"conflict_edge_count_exceeds\": 1,\n \"outlier_agents_count_exceeds\": 1\n }\n },\n \"fault_line\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"use_reputation_scores\": true\n },\n \"fleet\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"patterns\": {\n \"outliers\": true,\n \"cluster_partition\": true,\n \"min_pair_score_below\": 0.5\n }\n }\n },\n \"fleet_identification\": {\n \"by\": \"team_membership\"\n },\n \"fan_out\": {\n \"rule\": \"per_named_affected_agent\"\n }\n },\n \"change_note\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mnemom.ai/v1/postures/{posture_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"body\": {\n \"posture_schema_version\": \"v1.0\",\n \"sideband\": {\n \"coherence\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"fire_on\": {\n \"pairwise_governance_floor_below\": 0.5,\n \"conflict_edge_count_exceeds\": 1,\n \"outlier_agents_count_exceeds\": 1\n }\n },\n \"fault_line\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"use_reputation_scores\": true\n },\n \"fleet\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"patterns\": {\n \"outliers\": true,\n \"cluster_partition\": true,\n \"min_pair_score_below\": 0.5\n }\n }\n },\n \"fleet_identification\": {\n \"by\": \"team_membership\"\n },\n \"fan_out\": {\n \"rule\": \"per_named_affected_agent\"\n }\n },\n \"change_note\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"revision_id": "<string>",
"posture_id": "<string>",
"revision_no": 2,
"body": {},
"change_summary": "<string>",
"authored_by": "<string>",
"authored_at": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}Postures
Write a new revision of a posture (forward-only)
Creates a new immutable revision; updates current_revision_id pointer.
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": {
"posture_schema_version": "v1.0",
"sideband": {
"coherence": {
"enabled": true,
"cadence_seconds": 2,
"fire_on": {
"pairwise_governance_floor_below": 0.5,
"conflict_edge_count_exceeds": 1,
"outlier_agents_count_exceeds": 1
}
},
"fault_line": {
"enabled": true,
"cadence_seconds": 2,
"use_reputation_scores": true
},
"fleet": {
"enabled": true,
"cadence_seconds": 2,
"patterns": {
"outliers": true,
"cluster_partition": true,
"min_pair_score_below": 0.5
}
}
},
"fleet_identification": {
"by": "team_membership"
},
"fan_out": {
"rule": "per_named_affected_agent"
}
},
"change_note": "<string>"
}
'import requests
url = "https://api.mnemom.ai/v1/postures/{posture_id}"
payload = {
"body": {
"posture_schema_version": "v1.0",
"sideband": {
"coherence": {
"enabled": True,
"cadence_seconds": 2,
"fire_on": {
"pairwise_governance_floor_below": 0.5,
"conflict_edge_count_exceeds": 1,
"outlier_agents_count_exceeds": 1
}
},
"fault_line": {
"enabled": True,
"cadence_seconds": 2,
"use_reputation_scores": True
},
"fleet": {
"enabled": True,
"cadence_seconds": 2,
"patterns": {
"outliers": True,
"cluster_partition": True,
"min_pair_score_below": 0.5
}
}
},
"fleet_identification": { "by": "team_membership" },
"fan_out": { "rule": "per_named_affected_agent" }
},
"change_note": "<string>"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
body: JSON.stringify({
posture_schema_version: 'v1.0',
sideband: {
coherence: {
enabled: true,
cadence_seconds: 2,
fire_on: {
pairwise_governance_floor_below: 0.5,
conflict_edge_count_exceeds: 1,
outlier_agents_count_exceeds: 1
}
},
fault_line: {enabled: true, cadence_seconds: 2, use_reputation_scores: true},
fleet: {
enabled: true,
cadence_seconds: 2,
patterns: {outliers: true, cluster_partition: true, min_pair_score_below: 0.5}
}
},
fleet_identification: {by: 'team_membership'},
fan_out: {rule: 'per_named_affected_agent'}
}),
change_note: '<string>'
})
};
fetch('https://api.mnemom.ai/v1/postures/{posture_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.mnemom.ai/v1/postures/{posture_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'body' => [
'posture_schema_version' => 'v1.0',
'sideband' => [
'coherence' => [
'enabled' => true,
'cadence_seconds' => 2,
'fire_on' => [
'pairwise_governance_floor_below' => 0.5,
'conflict_edge_count_exceeds' => 1,
'outlier_agents_count_exceeds' => 1
]
],
'fault_line' => [
'enabled' => true,
'cadence_seconds' => 2,
'use_reputation_scores' => true
],
'fleet' => [
'enabled' => true,
'cadence_seconds' => 2,
'patterns' => [
'outliers' => true,
'cluster_partition' => true,
'min_pair_score_below' => 0.5
]
]
],
'fleet_identification' => [
'by' => 'team_membership'
],
'fan_out' => [
'rule' => 'per_named_affected_agent'
]
],
'change_note' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mnemom.ai/v1/postures/{posture_id}"
payload := strings.NewReader("{\n \"body\": {\n \"posture_schema_version\": \"v1.0\",\n \"sideband\": {\n \"coherence\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"fire_on\": {\n \"pairwise_governance_floor_below\": 0.5,\n \"conflict_edge_count_exceeds\": 1,\n \"outlier_agents_count_exceeds\": 1\n }\n },\n \"fault_line\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"use_reputation_scores\": true\n },\n \"fleet\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"patterns\": {\n \"outliers\": true,\n \"cluster_partition\": true,\n \"min_pair_score_below\": 0.5\n }\n }\n },\n \"fleet_identification\": {\n \"by\": \"team_membership\"\n },\n \"fan_out\": {\n \"rule\": \"per_named_affected_agent\"\n }\n },\n \"change_note\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.mnemom.ai/v1/postures/{posture_id}")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"body\": {\n \"posture_schema_version\": \"v1.0\",\n \"sideband\": {\n \"coherence\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"fire_on\": {\n \"pairwise_governance_floor_below\": 0.5,\n \"conflict_edge_count_exceeds\": 1,\n \"outlier_agents_count_exceeds\": 1\n }\n },\n \"fault_line\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"use_reputation_scores\": true\n },\n \"fleet\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"patterns\": {\n \"outliers\": true,\n \"cluster_partition\": true,\n \"min_pair_score_below\": 0.5\n }\n }\n },\n \"fleet_identification\": {\n \"by\": \"team_membership\"\n },\n \"fan_out\": {\n \"rule\": \"per_named_affected_agent\"\n }\n },\n \"change_note\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mnemom.ai/v1/postures/{posture_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"body\": {\n \"posture_schema_version\": \"v1.0\",\n \"sideband\": {\n \"coherence\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"fire_on\": {\n \"pairwise_governance_floor_below\": 0.5,\n \"conflict_edge_count_exceeds\": 1,\n \"outlier_agents_count_exceeds\": 1\n }\n },\n \"fault_line\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"use_reputation_scores\": true\n },\n \"fleet\": {\n \"enabled\": true,\n \"cadence_seconds\": 2,\n \"patterns\": {\n \"outliers\": true,\n \"cluster_partition\": true,\n \"min_pair_score_below\": 0.5\n }\n }\n },\n \"fleet_identification\": {\n \"by\": \"team_membership\"\n },\n \"fan_out\": {\n \"rule\": \"per_named_affected_agent\"\n }\n },\n \"change_note\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"revision_id": "<string>",
"posture_id": "<string>",
"revision_no": 2,
"body": {},
"change_summary": "<string>",
"authored_by": "<string>",
"authored_at": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
}
}Authorizations
BearerAuthApiKeyAuth
Supabase JWT token in Authorization: Bearer header
Headers
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 (tp-{8-hex}).
Pattern:
^tp-[a-z0-9-]{1,64}$Body
application/json
Response
Updated posture with new revision.
Versioned posture body. Immutable by handler discipline (forward-only). Matches revisionForResponse() exactly.
Required range:
x >= 1The versioned posture body (PostureBody shape; older revisions may predate the v1.0 schema).