Dossiers and verification

Asynchronously submit the current Capsule ID to an allowlisted Transparency Service

POST
/v1/protocol/dossiers/{dossier_id}/agent-action-capsule/scitt-registration

Creates an RFC 9943 Signed Statement over the raw Capsule ID and queues optional registration outside the authority hot path. The operation is idempotent by org, Capsule ID, and Transparency Service. A received but unverified receipt is persisted as RECEIPT_UNVERIFIED and never upgrades the record to anchored.

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

Path Parameters

dossier_id*string
Formatuuid

Query Parameters

org_id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/protocol/dossiers/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent-action-capsule/scitt-registration?org_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "service": "string",  "protocol_version": "string",  "capsule_id": "string",  "idempotent": true,  "anchored": true,  "status_path": "string",  "registration": {    "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b",    "dossier_id": "8a9bfc13-db6c-4e62-a117-1a4399450d29",    "capsule_id": "string",    "transparency_service": "http://example.com",    "status": "PENDING",    "registration_statement_base64url": "string",    "statement_verified": true,    "receipt_base64url": "string",    "receipt_profile": "string",    "receipt_verified": true,    "service_key_id": "string",    "attempt_count": 0,    "last_error": "string",    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  }}