Skip to content
deedglassdocs

approval_required

A policy says a person must approve this action, and the endpoint can’t wait for the decision.

HTTP 403 · policy_error · not retryable

What happened

Section titled “What happened”

A policy says a person must approve this action, and the endpoint can’t wait for the decision. POST /v1/actions doesn’t use this code: it answers 202 with status: pending_approval.

What to do

Section titled “What to do”

Ask someone to approve it in Console › Approvals. The action runs once they do.

Example

Section titled “Example”
HTTP 403 · approval_required
{
  "error": {
    "type": "policy_error",
    "code": "approval_required",
    "message": "This action needs approval. It runs once someone approves it in Console › Approvals.",
    "param": null,
    "request_id": "req_01j9zr3m5k8q2w7x4t6v0b1c9d",
    "doc_url": "https://docs.deedglass.com/errors/approval_required"
  }
}

The message is for a person and can get more exact over time: branch on type and code, never on the message.

In the SDKs

Section titled “In the SDKs”
SDK Raised as
TypeScript (@deedglass/sdk) PolicyDeniedError with code === "approval_required"
Python (deedglass) deedglass.PolicyDeniedError with .code == "approval_required"
Section titled “Related”