# Delete a role

<figure><img src="/files/sh5tZ0TCwZVJfCp2OoHC" alt=""><figcaption></figcaption></figure>

Delete a Role in the server. You can specify specific roles from your server or an ID / [Variable](/custom-commands-and-events/variables.md).

{% hint style="warning" %}
The bot must have Manage Roles permission in order to delete roles.
{% endhint %}

## Role Type

This selection will specify the targeted role to delete.

<figure><img src="/files/8Ijau76FPMP49EaB0JVR" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Specific Role " %}
This selection will allow you to select a specific role from your server to delete. It will show a dropdown menu to allow the selection.

### Specific Role

This is a dropdown menu allowing you to select a role from any server the bot is in. Remember that if the role you're trying to select isn't there, it most likely means it was very recently added, simply click the refresh icon next to the "?" in the image below to find your role.

<figure><img src="/files/ZHLbNEyF66U6W4a4WpOo" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Role ID or Variable" %}
This selection can target specific roles by their ID to delete. Selecting this type will prompt a new field to appear to input a ID or [Variable](/custom-commands-and-events/variables.md).

### Role ID or Variable

This field accepts a plain role ID or [variable](/custom-commands-and-events/variables.md) that returns a plain role ID. This role ID can't have any spaces or extra symbols, make sure it is a plain role ID.

<figure><img src="/files/q0327gHKRNkonQyWTWgT" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/nkLVSFu0RQc3w3OpwC8y" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## Enable Success/Error Handles

Enable Success / Error Handles to detect success and errors inside of the action block. This allows you to run different actions if something goes wrong with your action. Inside of the handle, there are 2 different paths which are used to detect the outcome of the action. The green path on the bottom left side of the block indicates success, while the red path on the bottom right side of the block indicates error. You may attach action blocks to each side of the handle to get the outcome of your action block.

<figure><img src="/files/pYtBPljHi13YFv89blSF" alt=""><figcaption></figcaption></figure>

The Success/Error Handles feature includes 3 different error variables you can use to get information on why the action block encountered an error. Check them out [here](/custom-commands-and-events/variables.md#error-variables).

<figure><img src="/files/i83ylvvBSlx8LDGrXqlJ" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.botghost.com/custom-commands-and-events/actions/role-actions/delete-a-role.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.