Decisions

Ingest a versioned Protocol signal envelope

POST
/v1/protocol/signals/envelopes

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
AuthorizationBearer <token>

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

X-Correlation-ID?string
Idempotency-Key?string

Request Body

application/json

protocol_version*string
Match^1\.[0-9]+(\.[0-9]+)?$
envelope_id*string
Formatuuid
org_id*string
source*
domain*string
metric_name*string
metric_type*string

Value in

  • "gauge"
  • "counter"
  • "event"
  • "categorical"
value*unknown
unit?string
recorded_at*string
Formatdate-time
ingested_at*string
Formatdate-time
dimensions?
semantic?
evidence?array<string>
Itemsitems <= 100
trace?
hash?string
Match^[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"}