Skip to main content
General·HTTP 403·API, CLI

Agent permissions don't allow this

agent_permission_denied

The request came from an agent, and the project's agent permissions do not allow an agent to do this.

What this means​

The project's agent permissions are set to read only, or they deny this action, or this is something agents can never do and a person has to do in the console.

How to fix it​

A project admin can change the project's agent permissions in the console. Otherwise a person makes this change in the console.

Retry behavior​

Sending the same request again gets the same answer until the agent permissions change.

How it appears in the response​

ComputeSphere returns errors as RFC 7807 Problem Details. The type field is the docs URL for this page — switch on code in your client.

{
  "type":    "https://docs.computesphere.com/errors/agent_permission_denied",
  "title":   "Agent permissions don't allow this",
  "status":  403,
  "code":    "agent_permission_denied",
  "detail":  "The request came from an agent, and the project's agent permissions do not allow an agent to do this.",
  "instance": "/v2/…",
  "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "trace_id":   null
}

The Content-Type header is application/problem+json. On field-level validation errors a non-empty errors[] array also appears, each entry carrying its own docs_url for the offending field.