Explain a held decision in customer-safe words
Organization API key with decision:read and role VIEWER or higher; the organization comes from the key. For a HOLD, BLOCK or ESCALATE decision, returns wording a support agent can pass on (no codes, check ids or figures) and an internal part with reason codes, check ids and the dossier id. An approved decision is 409 decision_not_held.
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
Path Parameters
A protocol decision evaluation id in the key's organization.
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/decisions/497f6eca-6276-4993-bfeb-53cbbbba6f08/explanation"{ "version": "decionis.decisions.explanation/1", "decision_id": "string", "disposition": "HOLD", "customer_safe": { "summary": "string", "next_step": "string" }, "internal": { "reason_codes": [ "string" ], "check_ids": [ "P01" ], "dossier_id": "string" }, "generated_by": "decionis.explanations.catalog/1"}Federate a native-surface decision into the shared audit ledger POST
Records a decision made by a Layer-A commerce surface (Amazon, eBay, Shopify) into the cross-surface SHA-256 audit ledger. When the full signed dossier is included it is persisted and becomes retrievable + exportable as a proof packet; otherwise only a ledger entry is appended (backward compatible).
Ingest a versioned Protocol signal envelope POST
Persists an evidence-bearing signal for deterministic policy evaluation and material-signal revalidation. Semantic classifier metadata is input evidence only and cannot mint an authority verdict or execution grant.

