Delete Permission

Remove a permission from an agent.
DELETE /api/permissions/{permission_id}

Authentication

Authorization
string
required
Bearer token (JWT) from /auth/login

Path Parameters

permission_id
string
required
The permission’s unique ID

Example Request

curl -X DELETE https://api.agentwarden.io/api/permissions/perm_123 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Response

Status: 204 No Content
The agent will immediately be unable to perform this action. Any in-flight permission checks may be denied.

Errors

404 Not Found - Permission doesn’t exist
{
  "detail": "Permission not found"
}
403 Forbidden - Permission belongs to another organization
{
  "detail": "Permission not found"
}