Skip to main content
GET
/
agents
/
{agent_id}
/
alignment-card
Get the agent's canonical alignment card
curl --request GET \
  --url https://api.mnemom.ai/v1/agents/{agent_id}/alignment-card \
  --header 'Authorization: Bearer <token>'
{
  "card_version": "<string>",
  "agent_id": "<string>",
  "values": {
    "declared": [
      "<string>"
    ],
    "definitions": {},
    "conflicts_with": [
      "<string>"
    ],
    "hierarchy": "lexicographic"
  },
  "autonomy": {
    "bounded_actions": [
      "<string>"
    ],
    "escalation_triggers": [
      {
        "condition": "<string>",
        "action": "escalate",
        "reason": "<string>"
      }
    ],
    "forbidden_actions": [
      "<string>"
    ],
    "max_autonomous_value": {
      "amount": 123,
      "currency": "<string>"
    }
  },
  "audit": {
    "retention_days": 123,
    "queryable": true,
    "trace_format": "<string>",
    "query_endpoint": "<string>",
    "tamper_evidence": "append_only",
    "storage": {
      "type": "local",
      "location": "<string>"
    }
  },
  "card_id": "<string>",
  "issued_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "principal": {
    "type": "human",
    "relationship": "delegated_authority",
    "identifier": "<string>",
    "escalation_contact": "<string>"
  },
  "conscience": {
    "mode": "augment",
    "values": [
      {
        "type": "BOUNDARY",
        "content": "<string>",
        "id": "<string>",
        "severity": "advisory"
      }
    ]
  },
  "integrity": {
    "enforcement_mode": "observe"
  },
  "capabilities": {},
  "enforcement": {
    "forbidden_tools": [
      {
        "pattern": "<string>",
        "reason": "<string>",
        "severity": "critical"
      }
    ],
    "unmapped_tool_action": "allow",
    "fail_open": true,
    "mode": "off",
    "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>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.mnemom.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns the canonical alignment card for an agent — the result of composing the Platform, Org, and Agent scopes (see Card composition). This is the document the gateway and observer evaluate on every request.

Content negotiation

Accept headerResponse body
text/yaml (default)YAML
application/yamlYAML
application/jsonJSON

Response headers

Every response includes X-Mnemom-Schema identifying the canonical card schema version.

Errors

See the Unified cards overview for the full card surface.

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Headers

Accept
enum<string>

Response format. YAML is canonical; JSON is returned only on explicit application/json.

Available options:
text/yaml,
application/yaml,
application/json

Path Parameters

agent_id
string
required

Agent identifier (e.g. smolt-abc123)

Query Parameters

include_composition
boolean
default:false

Include the _composition metadata block.

Response

Canonical alignment card.

UC-4 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.