---
title: "Delete a Discord guild role"
method: DELETE
path: "/v1/discord/guilds/{guildId}/roles/{roleId}"
tags: ["Discord"]
---

# Delete a Discord guild role

`DELETE /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

Permanently deletes a role from the guild and removes it from every member.
This cannot be undone.

Requires the bot to hold Manage Roles, and the target role must sit below the bot's
highest role.

## Path parameters

- `guildId` string, required
- `roleId` string, required

## Query parameters

- `accountId` string, required

## Response `200`

Role deleted.

- object
  - `success` boolean

## Other responses

- `400`: Invalid accountId, guildId, or roleId format.
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `403`: Discord refused the action (bot lacks Manage Roles, or the target role sits at or above the bot's highest role).
- `404`: Discord account not found, not accessible, or not bound to this guild.
- `502`: Discord was unreachable or returned an unclassified error.

## Changes

- **2026-10-06** `f8c8f34fb41a`: 1 warning
  - added the new `account` enum value to the `details/budgetScope` response property for the response status `401`
- **2026-10-02** `d556591af3f6`: 7 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `details` to the response with the `401` status
  - added the optional property `docUrl` to the response with the `401` status
  - added the optional property `param` to the response with the `401` status
  - …3 more

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/discord/guilds/:guildId/roles/:roleId/delete.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/4e74db179e73?raw)