> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Permissions

> Comment le rôle d’un token d’API détermine les endpoints qu’il peut appeler.

Chaque token d’API est rattaché à un **rôle** lors de sa création. Le token dispose exactement des droits de ce rôle, dans le workspace où il a été créé.

```text theme={null}
API token  →  role (admin, manager, sale, view_only or a custom role)  →  rights per object (Read, Write, Delete…)
```

* Vous choisissez le rôle dans le champ **Rôle** lorsque vous créez le token dans **Paramètres › Développeur › Tokens d'API**. Consultez [Tokens d’API](https://docs.qwoty.io/fr/user-guide/settings/developer/api-tokens.md).
* Les droits se modifient sur le rôle, dans **Paramètres › Rôle**. Modifier un rôle change immédiatement ce que peut faire chaque token qui y est rattaché. Consultez [Permissions des rôles](https://docs.qwoty.io/fr/user-guide/settings/users/reference/permissions.md).
* Un token n’a ni liste de permissions propre ni date d’expiration. Pour restreindre un token, rattachez-le à un rôle disposant de moins de droits.

## Ce qu'un token peut faire

Un token peut faire exactement ce que son rôle permet : lire un objet quand le rôle a le droit **Lire** dessus, le créer ou le modifier avec le droit **Écrire**, le supprimer avec le droit **Supprimer**.

| Endpoints | Réglage du rôle | Nom du droit dans les erreurs |
| - | - | - |
| [Clients](https://docs.qwoty.io/fr/api-reference/customers/create.md), [contacts](https://docs.qwoty.io/fr/api-reference/contacts/create.md), [adresses](https://docs.qwoty.io/fr/api-reference/addresses/create.md) | **Client** | `customer:write` |
| [Catalogues](https://docs.qwoty.io/fr/api-reference/catalogs/create.md), [catégories](https://docs.qwoty.io/fr/api-reference/categories/create), [prix](https://docs.qwoty.io/fr/api-reference/prices/list.md), [produits](https://docs.qwoty.io/fr/api-reference/products/create.md), [produits parents](https://docs.qwoty.io/fr/api-reference/product-parents/create.md), [conditions de paiement](https://docs.qwoty.io/fr/api-reference/payment-terms/create.md) | **Produits et tarification** | `product_pricing:write` |

Tous les endpoints exigent aussi un token valide (sinon `401`) et ne renvoient que les données du workspace du token.

## Réponse 403

Lorsque le rôle n’a pas le droit requis, l’API renvoie `403 Forbidden` et ne modifie aucune donnée :

```json theme={null}
{
  "error": "Insufficient permissions. Requires customer:write"
}
```

Le texte qui suit `Requires` indique le droit manquant. Accordez ce droit au rôle du token, ou utilisez un token rattaché à un autre rôle.

## Recommandations

* Créez un rôle dédié à chaque intégration (par exemple « Synchro ERP ») avec uniquement les objets dans lesquels elle écrit.
* Utilisez un token par intégration et par environnement, pour pouvoir en révoquer un sans affecter les autres.
* Pour les intégrations en lecture seule, utilisez un rôle qui n’a que des droits **Lire**.

Consultez aussi [Authentification](https://docs.qwoty.io/fr/developers/authentication.md) et [Gestion des erreurs](https://docs.qwoty.io/fr/developers/core-concepts/error-handling.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.