delete_role

Purpose

Deletes a role. Anyone holding it stays in the team but loses whatever the role granted.

Not tier-gated, unlike creating and updating. A creator whose tier lapsed has to be able to take access away. See what the tier gates.

Required ability

role:delete

Input schema

{
  "type": "object",
  "properties": {
    "role_id": {
      "type": "string",
      "description": "UUID of the role to delete. Irreversible."
    }
  },
  "required": ["role_id"]
}

Output shape

{
  "data": {
    "id": "d05e1a83-7c46-4f29-b613-8ae407c9d251",
    "deleted": true
  }
}

Emits role.deleted.

Example prompts

"Delete the auditor role — nobody's using it."

Failure modes

AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks role:delete.
RESOURCE_NOT_FOUND — no such role in any team the caller belongs to.

create_role
update_role — narrowing a role's permissions is usually better than deleting it, since it leaves everyone's assignment intact.
list_team_members — check who holds it first.
Roles API