Discord

Edit a Discord guild role

Changed on

Updates a role's name, color, hoist, mentionable flag, or permission bitfield. At least one field must be supplied. Omitted fields are left unchanged.

Requires the bot to hold Manage Roles, and the target role must sit below the bot's highest role. See the create-role operation for the re-invite requirement.

patch/v1/discord/guilds/{guildId}/roles/{roleId}

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/discord/guilds/{guildId}/roles/{roleId}
  • Auth: HTTP bearer

Path parameters

guildIdstring required

Discord guild snowflake ID

roleIdstring required

Discord role snowflake ID

Query parameters

accountIdstring required

SocialAccount _id of the Discord account bound to this guild

Request body

namestring
colorinteger
hoistboolean
mentionableboolean
permissionsstring

Permissions bitfield as a stringified integer

Response

Role updated.

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status