Skip to main content
PUT
/
alignment
/
agent
/
{agent_id}
Publish or replace the alignment manifest
curl --request PUT \
  --url https://api.mnemom.ai/v1/alignment/agent/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "card_version": "<string>",
  "agent_id": "<string>",
  "values": {
    "declared": [
      "<string>"
    ],
    "definitions": {},
    "conflicts_with": [
      "<string>"
    ]
  },
  "autonomy": {
    "bounded_actions": [
      "<string>"
    ],
    "escalation_triggers": [
      {
        "condition": "<string>",
        "reason": "<string>"
      }
    ],
    "forbidden_actions": [
      "<string>"
    ],
    "max_autonomous_value": {
      "amount": 123,
      "currency": "<string>"
    }
  },
  "audit": {
    "retention_days": 123,
    "queryable": true,
    "trace_format": "<string>",
    "query_endpoint": "<string>",
    "storage": {
      "location": "<string>"
    }
  },
  "card_id": "<string>",
  "issued_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "integrity": {},
  "capabilities": {},
  "enforcement": {
    "forbidden_tools": [
      {
        "pattern": "<string>",
        "reason": "<string>"
      }
    ],
    "fail_open": true,
    "grace_period_hours": 123
  },
  "extensions": {},
  "_composition": {
    "canonical_id": "<string>",
    "composed_at": "2023-11-07T05:31:56Z",
    "scopes_applied": [
      {
        "scope": "<string>",
        "version": 123,
        "template_version": 123,
        "card_id": "<string>"
      }
    ],
    "exemptions_applied": [
      "<string>"
    ],
    "source_card_id": "<string>",
    "source_policy_id": "<string>"
  }
}
'
{
  "card_version": "<string>",
  "agent_id": "<string>",
  "values": {
    "declared": [
      "<string>"
    ],
    "definitions": {},
    "conflicts_with": [
      "<string>"
    ]
  },
  "autonomy": {
    "bounded_actions": [
      "<string>"
    ],
    "escalation_triggers": [
      {
        "condition": "<string>",
        "reason": "<string>"
      }
    ],
    "forbidden_actions": [
      "<string>"
    ],
    "max_autonomous_value": {
      "amount": 123,
      "currency": "<string>"
    }
  },
  "audit": {
    "retention_days": 123,
    "queryable": true,
    "trace_format": "<string>",
    "query_endpoint": "<string>",
    "storage": {
      "location": "<string>"
    }
  },
  "card_id": "<string>",
  "issued_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "principal": {
    "identifier": "<string>",
    "escalation_contact": "<string>"
  },
  "conscience": {
    "values": [
      {
        "content": "<string>",
        "id": "<string>"
      }
    ]
  },
  "integrity": {},
  "capabilities": {},
  "enforcement": {
    "forbidden_tools": [
      {
        "pattern": "<string>",
        "reason": "<string>"
      }
    ],
    "fail_open": true,
    "grace_period_hours": 123
  },
  "extensions": {},
  "_composition": {
    "canonical_id": "<string>",
    "composed_at": "2023-11-07T05:31:56Z",
    "scopes_applied": [
      {
        "scope": "<string>",
        "version": 123,
        "template_version": 123,
        "card_id": "<string>"
      }
    ],
    "exemptions_applied": [
      "<string>"
    ],
    "source_card_id": "<string>",
    "source_policy_id": "<string>"
  }
}

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.