manage_member_roles

Add or remove roles from a guild member. This is a access-sensitive action requiring the destructive tier that follows the requester action tier and approval mode. Use only when explicitly asked to modify someone’s roles.

User guide / All capabilities

Contract

Effect: destructive. Evidence role: discovery_only.

Add or remove roles from a guild member. Access-sensitive change; 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": {
    "member_id": {
      "type": "string",
      "description": "The member's Discord ID (from resolve_member_identity)."
    },
    "add_roles": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of role IDs to add to the member."
    },
    "remove_roles": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of role IDs to remove from the member."
    },
    "reason": {
      "type": "string",
      "description": "Optional reason for the role change."
    }
  },
  "required": [
    "member_id"
  ]
}

Execution requirements

• actor_grant
• guild context should exist
• member must exist

Expected postconditions

• adds/removes roles from the member