create_role

Create a new role in the guild. This is a WRITE action that follows the requester action tier and approval mode. Use only when explicitly asked to create a role.

User guide / All capabilities

Contract

Effect: write. Evidence role: discovery_only.

Create a new role in the guild. Write — 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": {
    "name": {
      "type": "string",
      "description": "The name for the new role."
    },
    "color": {
      "type": "string",
      "description": "Optional: hex color for the role (e.g. '#FF0000'). Default: no color."
    },
    "hoist": {
      "type": "string",
      "enum": [
        "true",
        "false"
      ],
      "description": "Optional: whether to display the role separately in the sidebar. Default: false."
    },
    "mentionable": {
      "type": "string",
      "enum": [
        "true",
        "false"
      ],
      "description": "Optional: whether anyone can @mention this role. Default: false."
    },
    "reason": {
      "type": "string",
      "description": "Optional: reason for creating the role (audit log)."
    }
  },
  "required": [
    "name"
  ]
}

Execution requirements

• actor_grant
• guild context should exist

Expected postconditions

• creates a new role in the guild