delete_role

Delete a role from the guild. This is a DESTRUCTIVE action that follows the requester action tier and approval mode. Use only when explicitly asked to delete a role.

User guide / All capabilities

Contract

Effect: destructive. Evidence role: discovery_only.

Delete a role from the guild. Destructive — follows the requester action tier and approval mode.

Parameters

This is the current provider-facing JSON Schema, generated from the runtime definition.

{
  "type": "object",
  "properties": {
    "role_id": {
      "type": "string",
      "description": "The role ID to delete (from get_role_info or list_roles)."
    },
    "reason": {
      "type": "string",
      "description": "Optional reason for the deletion (audit log)."
    }
  },
  "required": [
    "role_id"
  ]
}

Execution requirements

• actor_grant
• guild context should exist
• role must exist

Expected postconditions

• deletes the role from the guild