Skip to main content
POST
/
alignment
/
org
/
{org_id}
/
preview-compose
Preview composed alignment (dry run)
curl --request POST \
  --url https://api.mnemom.ai/v1/alignment/org/{org_id}/preview-compose \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --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>"
  }
}
'
{
  "composed": {
    "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>"
    }
  },
  "conflicts": [
    {}
  ],
  "coherence_violations": [
    {}
  ]
}

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Path Parameters

org_id
string
required

Organization identifier (e.g. org-abc12345)

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

Preview-compose result: composed card + conflicts + coherence violations.

composed
object

Unified alignment card (ADR-008). Authored in YAML or JSON; composed server-side with platform defaults, org template, and active exemptions before storage.

conflicts
object[]
coherence_violations
object[]