Reference
API Overview
The Registry, Decision, and Execution API specifications, and the minimal action envelope.
Three OpenAPI specs — one per trust domain. Import into any OpenAPI-compatible toolchain.
Registry API
Governance objects: tasks, capabilities, liability bindings, skills, revocations.
Decision API
Evidence, impact assessment, policy evaluation, approvals, escalations.
Execution API
Action envelopes, receipts, event ledger, replay.
Minimal action envelope
The action envelope is the execution gate. Every field must resolve to a valid, non-revoked artifact.
// POST /agp/execution/action-envelopes
{
"object_type": "action_envelope",
"task_id": "tsk_01HXYZ...",
"capability_token": "cap_01HABC...", // must be valid, unexpired, unrevoked
"liability_binding": "lib_01HDEF...",
"decision_record": "dec_01HGHI...",
"policy_decision": "pol_01HJKL...", // must be ALLOW or APPROVED
"approval_artifact": "apr_01HMNO...", // required for high/critical risk
"action": {
"type": "tool_call",
"tool": "send_payment",
"params": { "amount_usd": 500, "recipient": "..." }
},
"idempotency_key": "idem_01HPQR..."
}