Ingest a versioned Protocol signal envelope
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.
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
^1\.[0-9]+(\.[0-9]+)?$uuidValue in
- "gauge"
- "counter"
- "event"
- "categorical"
date-timedate-timeitems <= 100^[A-Fa-f0-9]{64}$Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/protocol/signals/envelopes" \ -H "Content-Type: application/json" \ -d '{ "protocol_version": "string", "envelope_id": "cd819e97-5425-4178-8fcc-567f1dc109ce", "org_id": "string", "source": { "provider": "string", "mode": "DIRECT_API" }, "domain": "string", "metric_name": "string", "metric_type": "gauge", "value": null, "recorded_at": "2019-08-24T14:15:22Z", "ingested_at": "2019-08-24T14:15:22Z" }'{ "accepted": true, "service": "string", "protocol_version": "string", "artifact": "policy_bundle", "artifact_id": "string", "org_id": "string", "received_at": "2019-08-24T14:15:22Z"}Explain a held decision in customer-safe words GET
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.
List shadow-mode decision evaluation reports GET
Returns protocol-owned shadow reports derived from saved evaluate-decision records. Reports summarize what Decionis would continue, stop, hand off, or review without exposing policy rules.

