> For the complete documentation index, see [llms.txt](https://doc-builder.oftone.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc-builder.oftone.fr/reference/blocs/create-role.md).

# Créer un rôle

**Catégorie** — Rôles

Crée un rôle avec ses réglages de couleur, d’affichage et de permissions.

![Créer un rôle dans le builder](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-96d5660a1f66dc31b55f5ff17bd558a6e988020c%2Fcreate-role.png?alt=media)

## Paramètres

| Réglage                       | Valeurs acceptées                                                |
| ----------------------------- | ---------------------------------------------------------------- |
| Nom                           | Texte · 100 caractères maximum · obligatoire                     |
| Couleur principale            | Couleur                                                          |
| Style de couleur              | Choix · Classique, Dégradé, Holographique · par défaut Classique |
| Couleur secondaire du dégradé | Couleur                                                          |
| Afficher séparément           | Interrupteur                                                     |
| Mentionnable                  | Interrupteur                                                     |
| Permissions                   | Liste de permissions Discord                                     |
| Icône (image data URI base64) | Texte · 300000 caractères maximum                                |
| Emoji Unicode                 | Texte · 100 caractères maximum                                   |
| Raison                        | Texte · 512 caractères maximum                                   |

## Entrées, sorties et variables

Une entrée et une sortie d’action. Utilisez les variables indiquées par le sélecteur dans les champs de texte et d’identifiants.

## Exécution et limites

L’agent transmet l’action à Discord et poursuit si elle réussit. Le bot doit pouvoir utiliser la permission Discord `ManageRoles` dans le contexte cible. Dans un outil, le rôle doit être non mentionnable et sans permissions supplémentaires. Son ID est disponible dans `{tool_created_role_id}`.

## Exemple

Créez « Atelier » sans permissions supplémentaires ; dans un outil, réutilisez `{tool_created_role_id}` dans Ajouter un rôle.

## Erreurs courantes

Vérifiez les ID et l’accès du bot à la cible. Pour un rôle ou un membre, contrôlez aussi la hiérarchie Discord. Reliez une branche d’erreur pour afficher un retour.

## Blocs associés

[Ajouter un rôle](/reference/blocs/add-role.md) · [En cas d’erreur](/reference/blocs/error-root.md)
