---
title: "POST /agents/{agentId}/permissions"
method: POST
path: "/agents/{agentId}/permissions"
---

# POST /agents/{agentId}/permissions

`POST /agents/{agentId}/permissions`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/agents/{agentId}/permissions`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `agentId` string, required: Agent to change

## Request body

- object: Set one standing decision for an agent
  - `procedurePath` string: Procedure to set. Omit when setting bypassReads.
  - `state` 'ASK' | 'ALWAYS_ALLOW' | 'NEVER': Required with procedurePath
  - `bypassReads` boolean: Turn the blanket read-only grant on or off. Omit when setting a procedure.

## Response `200`

OK

- object: The decision as it now stands
  - `agentId` string, required
  - `procedurePath` string, nullable, required
  - `state` 'ASK' | 'ALWAYS_ALLOW' | 'NEVER', nullable, required: ASK (file a request and wait for the owner), ALWAYS_ALLOW (proceed without asking), NEVER (refuse outright and do not queue a request).
  - `bypassReads` boolean, required

## Other responses

- `403`: 403
- `404`: 404
- `422`: 422

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)