# Get Roles by Name

**Introduction**&#x20;

This step is used to search for and list all roles in a guild that match a provided name.

**Description**&#x20;

Retrieves a list of roles whose names exactly match the provided name, with the search being case-sensitive.

**Configuration**

1. **Guild**: Select the guild in which to search for roles. This is a required field.
2. **Name**: Enter the name of the roles to find. The name must be between 1 and 100 characters. This is a required field.

**Outputs**

* **Roles**: A list of roles from the guild that match the specified name criteria.

**Usage**&#x20;

Ideal for locating specific roles within a guild.

**Permissions**

* No specific permissions are required for this search operation.


---

# 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://docs.flexy.bot/modules/discord/steps/get-roles-by-name.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.
