ShieldAuthorization
Start or resume human approval for an ASK decision
Orchestrates Presence when policy requires the user. The caller must keep the consequential action on hold until this endpoint returns an ALLOW decision.
Authorization
shieldApiKey AuthorizationBearer <token>
In: header
Path Parameters
decisionId*string
Match
^dec_[A-Za-z0-9_-]+$Header Parameters
X-Shield-App-Id*string
Registered integration identity. The server resolves trusted display metadata.
Length
3 <= length <= 120X-Shield-Environment*string
Value in
- "sandbox"
- "production"
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/shield/decisions/string/approval" \ -H "X-Shield-App-Id: string" \ -H "X-Shield-Environment: sandbox"{ "verdict": "ALLOW", "allowed": true, "approvalRequired": true, "approvalStatus": "NOT_REQUIRED", "reason": "string", "reasonCode": "string", "requestId": "string", "decisionId": "string", "dossierId": "string", "environment": "sandbox", "advanced": { "policyVersion": "string", "reasonCodes": [ "string" ], "evidenceHash": "string", "signatures": {}, "evaluationMetadata": {} }}