Skip to content
deedglassdocs

insufficient_role

You’re signed in, and your role in the org is below what the endpoint needs.

HTTP 403 · permission_error · not retryable

What happened

Section titled “What happened”

You’re signed in, and your role in the org is below what the endpoint needs. Viewers read; admins also change agents, keys, policies and connectors, invite and remove viewers and admins, and stop agents; owners also invite owners, change roles and start all agents again. Roles are read on every request, so a change applies at once.

What to do

Section titled “What to do”

Ask an owner to change your role (Console › Settings › Members, or PATCH /v1/org/members/{id}).

Example

Section titled “Example”
HTTP 403 · insufficient_role
{
  "error": {
    "type": "permission_error",
    "code": "insufficient_role",
    "message": "Your role in Acme is Viewer, and inviting people needs Admin. Ask an owner to change your role.",
    "param": null,
    "request_id": "req_01j9zr3m5k8q2w7x4t6v0b1c9d",
    "doc_url": "https://docs.deedglass.com/errors/insufficient_role"
  }
}

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) PermissionDeniedError with code === "insufficient_role"
Python (deedglass) deedglass.PermissionDeniedError with .code == "insufficient_role"
Section titled “Related”