Evaluate captured execution intent through the SDK compatibility route
Deprecated
Backwards-compatible alias for SDKs before the canonical protocol route.
Authorization
ApiKeyAuth An organization API key. Its scopes decide what it may call;
decision:shadow is the narrowest: SHADOW evaluations through
POST /v1/authority/grants or its alias
POST /v1/authority/enforce-and-bind only (DECISION_SHADOW_MODE_DENIED
in any other mode; DECISION_SHADOW_FIELD_DENIED for a body carrying
context.decionis_policy, evidence or escalation), with no
integration dispatch. A key whose only scope is decision:shadow
(an AgentSafe hosted gateway's) reaches exactly those two,
POST /v1/auth/credential-context, POST /v1/hosted-gateway/keys/confirm
and POST /v1/hosted-gateway/keys/revoke-self; every other route
answers 403 HOSTED_GATEWAY_KEY_PATH_DENIED.
decision:enforce is an enforced hosted gateway's key: evaluations
in SHADOW or ENFORCEMENT through POST /v1/authority/grants or its
alias (400 DECISION_ENFORCE_FIELD_DENIED for a body carrying
context.decionis_policy; it never holds policy:write), and the
grants and managed escalations they bind. A key whose scopes are
decision:enforce (with or without decision:shadow) reaches exactly
POST /v1/authority/enforce-and-bind, POST /v1/authority/grants,
GET /v1/authority/grants/{grant_id},
POST /v1/authority/grants/{grant_id}/claims,
POST /v1/authority/grants/{grant_id}/receipts,
POST /v1/authority/grants/{grant_id}/reconciliations,
POST /v1/execution/verify-token, POST /v1/execution/claim-token,
POST /v1/execution/consume-token, POST /v1/execution/finalize-token,
GET /v1/authority/escalations/{escalation_id},
DELETE /v1/authority/escalations/{escalation_id},
POST /v1/auth/credential-context, POST /v1/hosted-gateway/keys/confirm
and POST /v1/hosted-gateway/keys/revoke-self, each id a UUID; every
other route answers 403 HOSTED_GATEWAY_KEY_PATH_DENIED.
In: header
Header Parameters
Request Body
application/json
false"enforce"Value in
- "enforce"
- "shadow"
- "dry_run"
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/decisions/evaluate" \ -H "Content-Type: application/json" \ -d '{ "tenant_id": "string", "actor": { "id": "string", "type": "AI_AGENT" }, "action": { "type": "TRANSFER_FUNDS" } }'{ "decision_id": "string", "status": "ALLOW", "reason_codes": [ "string" ], "explanation": "string", "dossier_url": "http://example.com", "signature": { "algorithm": "Ed25519", "value": "string" }, "latency_ms": 0}Recover a recorded evaluation receipt after an ambiguous response GET
Read-only recovery for an authenticated protocol service identity and its authorized organization. Ordinary organization and platform API keys are rejected. Requires the service bearer token and X-Org-ID header. Does not evaluate an action or return request, customer, or decision payloads. The mode is the original persisted effective response mode, corroborated by the evaluation row. Missing, unknown, or conflicting mode evidence returns null; it is never inferred from requested mode or current workspace settings. Consumers must not treat null, SHADOW, or PARALLEL as paid enforcement. A not_found receipt is not evidence of a completed evaluation.
Govern a spend request (Gate 1 — spend admission) POST
Evaluates an expense / vendor-payment / refund / credit request against the ops spend-control vertical pack (approval threshold + dual authorization, vendor verification, refund/credit limits). Runs the full shared evaluate-decision pipeline and returns a signed dossier reference.

