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

# Budgets

> Découvrez comment les budgets Enterprise forment une arborescence de limites d’ACU, comment définir des périodes mensuelles et des niveaux utilisateur propres à chaque budget, et comment gérer les budgets via l’API.

Les budgets vous permettent de plafonner l’utilisation des ACU selon l’organisation de votre entreprise : une limite pour le compte, des réserves partagées pour les équipes ou les projets, et des limites par utilisateur au sein de chaque réserve.

## Exemples de cas d’utilisation

### Départements avec administrateurs délégués

Acme Corp compte 10 départements. Chaque responsable de département gère les limites de ses organisations, tandis que le service informatique central fixe le total alloué à chaque département. Cet exemple en présente deux.

Alice, l’administratrice d’entreprise, crée un budget pour chaque département sous le budget du compte, puis partage chacun d’eux avec l’administrateur du département concerné. Chaque administrateur de département crée ensuite un budget pour chacune de ses organisations.

![Budget du compte de 100,000 ACU, avec Engineering à 30,000 ACU, qui comprend Payments et Search, et Marketing à 5,000 ACU.](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/budget-departments.svg?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=bfecc16bdf0286471712d39161e2567c)

Budgets des départements sous le budget du compte

* Bob, l’administrateur du département Engineering, peut définir des limites, y compris temporaires, sur n’importe quel budget rattaché à Engineering. Par exemple, il peut accorder à Payments une limite temporaire de 6,000 ACU pour une semaine chargée.
* Bob ne peut pas relever la limite de 30,000 ACU d’Engineering : seule Alice en a la possibilité.
* L’utilisation de toutes les organisations d’Engineering est imputée sur la limite de 30,000 ACU, même si la somme des budgets des organisations la dépasse.

![Page Budgets vue par un administrateur de département](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/dept-admin-tree.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=cd8d27a58bfeb28446df8597ac4c2dc1)

La page Budgets vue par un administrateur de département, avec le budget du compte verrouillé

![Relèvement de la limite d’un budget enfant](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/dept-admin-edit-child.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=1c1c05e9681f2e62a5b95b344f476a41)

Un administrateur de département relève la limite d’un budget enfant

![La limite du budget du département est en lecture seule](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/dept-admin-own-limit.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=55c58f67119cb0af4c2f17d1db5d1f0a)

Un administrateur de département ne peut pas modifier la limite du budget de son département

### Un budget de projet avec des limites par utilisateur plus élevées

Chaque développeur dispose de 200 ACU par mois. Pour l’initiative de migration, Acme Corp réserve 5,000 ACU et autorise les membres du projet à en consommer davantage.

Conservez les organisations Developer tools dans un budget Developer tools avec un niveau par défaut de 200 ACU. Créez un budget Migration initiative avec une limite de 5,000 ACU. Placez-y l’organisation du projet et attribuez-lui un niveau par défaut de 1,000 ACU. Les deux budgets dépendent du budget du compte.

![Developer tools à 20,000 ACU avec un niveau par défaut de 200 ACU, et Migration initiative à 5,000 ACU avec un niveau par défaut de 1,000 ACU.](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/budget-project.svg?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=cb189c909fb5c07095bd6d1f2c406cd6)

Budgets Developer tools et Migration initiative avec leurs niveaux

* Carol, développeuse affectée au projet, peut utiliser jusqu’à 1,000 ACU dans l’organisation Migration, et jusqu’à 200 ACU dans les organisations Developer tools.
* L’ensemble du projet ne peut en aucun cas dépasser 5,000 ACU par mois.

![Sélecteur de budget de Mes analyses](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/my-analytics-multi-budget.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=cf5fd4ca8608b542fec5484fb003985c)

Sélecteur de budget de Mes analyses avec plusieurs budgets

## Fonctionnement des budgets

### Arborescence des budgets

Chaque compte Enterprise dispose d’une seule arborescence de budgets. Sa racine est le **budget du compte**, sous lequel se trouvent les budgets enfants. Une arborescence peut compter jusqu’à trois niveaux de profondeur.

Un budget peut contenir une ou plusieurs organisations. Chaque organisation appartient à un seul et unique budget. Les nouvelles organisations sont placées sous le budget du compte.

Par exemple, Acme Corp fixe une limite de 100,000 ACU pour son budget du compte. Engineering répartit son pool entre trois budgets enfants.

![Budget du compte de 100,000 ACU, avec Engineering à 40,000 ACU et ses trois budgets enfants, et Developer tools à 20,000 ACU avec trois niveaux de limite par utilisateur.](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/budget-tree.svg?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=923ef86ef029390214dbdd478d4f9328)

Arborescence des budgets avec budgets et niveaux de limite par utilisateur

Les niveaux sont des limites par utilisateur au sein d’un même budget, et non des budgets distincts.

![Arborescence des budgets avec l’utilisation de chaque budget](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/tree.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=70ff5c75cc82a29a77669afc77de160f)

Arborescence des budgets avec l’utilisation de chaque budget (données fictives)

### Limites de budget

Une limite de budget plafonne l’utilisation cumulée des ACU par les organisations du budget et celles de ses budgets enfants, sur une période mensuelle. Une limite `null` signifie qu’il n’y a aucune limite.

* **L’utilisation est imputée à chaque ancêtre.** L’utilisation dans un budget enfant est également imputée à son parent et au budget du compte.
* **Un ancêtre épuisé bloque ses enfants.** Dès qu’un budget du chemin est épuisé, l’utilisation s’arrête dans toute cette branche.
* **La somme des limites des enfants peut dépasser la limite du parent.** La limite du parent continue de plafonner leur utilisation cumulée.
* **Un budget sans limite reste plafonné par ses parents.**

Un budget lié à une seule organisation partage sa limite avec cette organisation. Les [points de terminaison de limite d’ACU au niveau de l’organisation](https://docs.devinenterprise.com/fr/admin/billing/org-acu-limits#organization-endpoints), désormais obsolètes, permettent également de la définir. Vous pouvez aussi utiliser le [point de terminaison de mise à jour](#update-a-budget) ci-dessous.

### Ce qui se passe lorsqu'un budget est épuisé

Lorsqu'un budget est épuisé, l'utilisation est interrompue pour ses organisations. Elle l'est également dès qu'un budget parent est épuisé. L'utilisation reprend à la période mensuelle suivante, ou dès qu'un administrateur relève la limite ou définit une limite temporaire.

* **Sessions Devin :** il n'est plus possible de démarrer de nouvelles sessions, et les sessions en cours passent en veille. Les utilisateurs voient le message « Increase your organization's usage limit. »
* **Devin CLI et agent local de l'application de bureau :** les requêtes sont bloquées. Les utilisateurs voient le message « Your organization has reached its monthly usage limit. Ask an account admin to raise it, or wait for the limit to reset next month. »
* **Devin Review :** les nouvelles revues sont bloquées.

![Bannière du composer : limite d'utilisation atteinte](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/cloud-limit-reached.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=b4183e12594ad3d8d84eb223dc6d1246)

Bannière du composer lorsque le budget est épuisé

### Période mensuelle

Les limites de budget, les limites utilisateur et les limites temporaires sont réinitialisées au début de chaque période mensuelle. Chaque période commence le jour de début de votre phase de facturation et ne correspond donc pas toujours au mois calendaire.

Par exemple, si la phase de facturation commence le 15, les périodes vont du 15 octobre au 14 novembre, puis du 15 novembre au 14 décembre.

Une **limite temporaire** remplace la limite du budget pour le reste de la période actuelle. La limite permanente s’applique de nouveau dès la période suivante. Une dérogation utilisateur temporaire expire à la fin de la période actuelle.

![Budget Marketing avec une limite temporaire](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/limits-temporary.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=8a19713130eef30fae3153e10400f77d)

Une limite temporaire porte le budget Marketing à 6,000 ACU pour cette période uniquement

### Limites utilisateur dans un budget

Les limites utilisateur plafonnent la consommation d’une personne sur une période mensuelle. Chaque budget lié à une organisation dispose de ses propres limites utilisateur, qui s’appliquent uniquement au sein de ce budget.

* **Niveaux.** Chaque budget possède ses propres niveaux, dont un niveau par défaut. Un niveau définit la limite mensuelle d’ACU applicable à ses membres.
* **Mappages de groupe IdP.** Mappez un groupe du fournisseur d’identité à un niveau. Les membres du groupe se voient attribuer ce niveau.
* **Dérogations.** Définissez une limite permanente ou temporaire pour un utilisateur donné.
* **Politiques de demande.** Chaque niveau détermine le traitement des demandes d’augmentation de limite. `unconditional` et `conditional` approuvent les demandes jusqu’à la valeur `max_limit` du niveau. `manual` transmet les demandes à un administrateur pour revue.
* **Périmètre.** Une limite utilisateur ne prend en compte que l’utilisation de l’utilisateur dans les organisations de ce budget.
* **Copie et effacement.** Copiez les niveaux d’un autre budget ou du compte. Vous pouvez également copier les mappages de groupe IdP, les attributions et les dérogations. Effacez tous les niveaux d’un budget pour repartir de zéro.

> [!WARNING]
>
> Une limite utilisateur définie sur un budget parent ne s’applique pas à ses budgets enfants. Par exemple, si Engineering contient également une organisation, une limite utilisateur de 300 ACU sur Engineering ne plafonne pas l’utilisation d’un utilisateur dans Payments ou Search.

![Boîte de dialogue de copie des politiques d’utilisation](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/copy-policies.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=cc1c5fce8d56e535d8502eab0501729b)

Boîte de dialogue de copie des politiques d’utilisation, avec Developer tools comme source

### Qui peut gérer un budget

Les Enterprise Admin gèrent les budgets dans **Enterprise Settings**, sous **Budgets**. Ils gèrent l’ensemble de l’arborescence, y compris le budget du compte.

* **Délégation.** Un administrateur d’entreprise peut partager un budget avec une personne ou un groupe depuis l’onglet Manage access. Un administrateur délégué peut alors créer des budgets enfants sous ce budget, et définir des limites et des limites temporaires pour ces budgets enfants. La délégation doit être activée séparément ; contactez votre équipe chargée du compte.
* **Un administrateur délégué ne peut pas augmenter la limite du budget partagé lui-même.** Seul un administrateur qui gère le budget parent peut la modifier.
* Les **Membres** consultent leur propre utilisation et leur limite dans Mes analyses.

![Onglet Manage access du budget Engineering](https://mintcdn.com/cognitionai-enterprise/0zaCf8BmcmvBSHzW/images/admin/budgets/dept-admin-access.png?fit=max\&auto=format\&n=0zaCf8BmcmvBSHzW\&q=85\&s=58dc7d60892a7eba7a56297055dacd8f)

Onglet Manage access du budget Engineering, avec Bob comme gestionnaire

## Questions fréquentes

> [accordion] Les administrateurs de l’organisation peuvent-ils définir la limite d’ACU d’une organisation ?
>
> Non. Ce sont les Enterprise Admin qui définissent les limites d’ACU des organisations. Pour permettre à une équipe de gérer ses propres limites, partagez un budget avec l’administrateur de cette équipe.

> [accordion] Pourquoi l’endpoint de limite d’organisation renvoie-t-il une erreur 409 ?
>
> Une fois les limites de budget imposées pour votre entreprise, l’endpoint de limite d’organisation renvoie le code HTTP `409` lorsque l’organisation partage son budget avec d’autres organisations ou lorsqu’elle est rattachée directement au budget du compte. Le message d’erreur est le suivant : « This organization has no limit of its own. Set the limit on its budget. » Par exemple, si Globex, Initech et Umbrella partagent un même budget, toute tentative de définir une limite pour Globex renvoie `409`.

> [accordion] Quand les limites sont-elles réinitialisées ?
>
> Au début de chaque période mensuelle. Celle-ci commence le jour de début de votre phase de facturation.

> [accordion] Une organisation peut-elle appartenir à deux budgets ?
>
> Non. Chaque organisation appartient à un seul et unique budget. Un budget peut en revanche contenir plusieurs organisations.

## Gérer les budgets avec l’API V3

Toutes les requêtes s’authentifient au moyen d’un **jeton d’utilisateur de service** Enterprise. Les appelants doivent disposer de l’autorisation de compte **ManageAcuLimits** ou d’un [accès délégué](#who-can-manage-a-budget) au budget. Utilisez `https://api.devin.ai` comme URL de base. Consultez la [vue d’ensemble de l’API V3](https://docs.devinenterprise.com/fr/api-reference/v3/overview.md) pour en savoir plus sur l’authentification et pour obtenir des consignes sur les utilisateurs de service.

Les points de terminaison de collection budget-scoped indiquent le budget dans le chemin : `/v3beta1/enterprise/usage-policies/budgets/{budget_id}/...`. Les points de terminaison qui ciblent un niveau ou une demande spécifique (`/tiers/{tier_id}`, `/requests/{request_id}`) déduisent le budget du niveau ou de la demande ; ils partagent donc leurs chemins avec les points de terminaison à l’échelle du compte.

### Sémantique de PATCH

Pour les points de terminaison `PATCH` :

* Un champ omis reste inchangé.
* Un champ défini sur `null` est effacé.
* Un champ auquel une valeur est attribuée est créé ou mis à jour.

## Points de terminaison des budgets

### Lister les budgets

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets
```

Renvoie une liste paginée des budgets du compte, actifs et archivés. Chaque budget se présente comme suit :

```json theme={null}
{
  "budget_id": "budget-abc123",
  "name": "Engineering",
  "parent_budget_id": "budget-root",
  "org_ids": ["org-xyz789"],
  "status": "active",
  "cycle_acu_limit": 2000,
  "temporary_cycle_acu_limit": null
}
```

* `budget_id` : l'identifiant à utiliser dans les chemins budget-scoped.
* `parent_budget_id` : le budget parent ; `null` pour le budget racine du compte.
* `org_ids` : les organisations liées à ce budget. Leur utilisation est imputée à ce budget. Vide si aucune organisation n'est liée.
* `status` : `active` ou `archived`.
* `cycle_acu_limit` : la limite de consommation d’ACU imputée au budget et à ses descendants pour chaque période de facturation mensuelle ; `null` signifie qu'il n'y a aucune limite.
* `temporary_cycle_acu_limit` : une limite qui remplace `cycle_acu_limit` jusqu'à la fin de la période de facturation mensuelle en cours ; `null` si aucune limite temporaire n'est en vigueur.

### Mettre à jour un budget

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/budgets/{budget_id}
```

Mise à jour partielle : les champs omis restent inchangés et `null` efface une limite. Au moins un champ est obligatoire.

* `parent_budget_id` : déplace le budget, ainsi que ses sous-budgets, sous un autre budget actif. Le budget racine ne peut pas être déplacé, et les budgets peuvent être imbriqués sur trois niveaux au maximum.
* `cycle_acu_limit`, `temporary_cycle_acu_limit` : les limites du budget, telles qu'elles figurent dans la réponse de la liste.

**Corps de la requête — définir la limite et une augmentation temporaire pour ce mois-ci**

```json theme={null}
{
  "cycle_acu_limit": 2000,
  "temporary_cycle_acu_limit": 2500
}
```

**Corps de la requête — supprimer les limites**

```json theme={null}
{
  "cycle_acu_limit": null,
  "temporary_cycle_acu_limit": null
}
```

**Corps de la requête — déplacer le budget sous un autre budget**

```json theme={null}
{
  "parent_budget_id": "budget-platform"
}
```

Renvoie le budget mis à jour. Redéfinir `temporary_cycle_acu_limit` le relance pour la fenêtre actuelle. Pour un budget lié à exactement une organisation, `cycle_acu_limit` devient également la limite d’ACU de l'organisation.

## Points de terminaison de niveau

### Lister les niveaux

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/tiers
```

Renvoie une liste paginée des niveaux du budget, triés par ordre de priorité : `priority` la plus élevée en premier, puis, à priorité égale, du niveau le plus récent au plus ancien. Chaque niveau se présente comme suit :

```json theme={null}
{
  "tier_id": "tier-abc123",
  "name": "Engineers",
  "is_default": true,
  "cycle_acu_limit": 500,
  "policy": "manual",
  "max_limit": null,
  "priority": 0,
  "member_count": 42,
  "created_at": 1735689600
}
```

* `is_default` : indique s'il s'agit du niveau par défaut du budget.
* `cycle_acu_limit` : limite d’ACU par défaut par cycle pour chaque membre ; `null` signifie non plafonné.
* `policy` : mode de traitement des demandes d’augmentation de limite portant sur ce niveau — `unconditional` et `conditional` les approuvent jusqu'à `max_limit`, tandis que `manual` exige une revue par un administrateur.
* `max_limit` : limite maximale jusqu'à laquelle les demandes d’augmentation sont approuvées ; avec `null`, elles sont approuvées sans plafond. Toujours `null` lorsque `cycle_acu_limit` vaut `null`.
* `priority` : rang du niveau parmi les niveaux mappés au groupe IdP d'un utilisateur — la valeur la plus élevée l'emporte ; en cas d'égalité, le niveau le plus récent prévaut. Une attribution explicite à un utilisateur prime sur ce classement, et le niveau par défaut n'est jamais classé.
* `member_count` : nombre d'utilisateurs actuellement rattachés au niveau. Pour le niveau par défaut, ce nombre comprend tous les membres du budget qui n'appartiennent à aucun autre niveau.

### Créer un niveau

```http theme={null}
POST /v3beta1/enterprise/usage-policies/budgets/{budget_id}/tiers
```

**Corps de la requête**

```json theme={null}
{
  "name": "Engineers",
  "cycle_acu_limit": 500,
  "policy": "manual"
}
```

Le premier niveau du budget devient automatiquement son niveau par défaut. Renvoie un code HTTP `201` avec le niveau créé.

### Récupérer un niveau

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

### Mettre à jour un niveau

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

Mise à jour partielle ; les champs omis restent inchangés.

```json theme={null}
{
  "name": "Engineering",
  "cycle_acu_limit": 750
}
```

### Supprimer un niveau

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}
```

Renvoie HTTP `204` en cas de réussite. Le niveau par défaut ne peut pas être supprimé (promouvez d'abord un autre niveau). Avant de supprimer un niveau, vous devez déplacer les utilisateurs qui y sont encore rattachés et supprimer toute mise en correspondance de groupe IdP vers ce niveau.

## Points de terminaison des utilisateurs de niveau

### Lister les utilisateurs d'un niveau

```http theme={null}
GET /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users
```

Renvoie une liste paginée des utilisateurs du niveau, avec leurs limites déterminées. Pour le niveau par défaut, il s'agit de tous les membres du budget qui n'appartiennent à aucun autre niveau :

```json theme={null}
{
  "user_id": "user_abc123",
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "cycle_acu_limit_override": null,
  "temporary_cycle_acu_limit": 800,
  "effective_cycle_acu_limit": 800,
  "limit_source": "temporary_override",
  "membership": "explicit"
}
```

* `cycle_acu_limit_override` : la dérogation permanente de l'utilisateur, le cas échéant.
* `temporary_cycle_acu_limit` : la dérogation temporaire de l'utilisateur, présente uniquement tant qu'elle est en vigueur dans la période de facturation mensuelle en cours.
* `effective_cycle_acu_limit` : la limite actuellement imposée à l'utilisateur ; `null` signifie qu'il n'est pas plafonné.
* `limit_source` : l'origine de la limite effective — `override` (permanente), `temporary_override` ou `tier`.
* `membership` : la raison pour laquelle l'utilisateur appartient au niveau — `explicit` (assigné directement), `idp_group` (via sa mise en correspondance de groupe IdP prioritaire) ou `default` (repli sur le niveau par défaut).

### Attribuer un niveau à un utilisateur

```http theme={null}
PUT /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}
```

Idempotent. Renvoie le code HTTP `204` en cas de réussite. Déplacer un utilisateur depuis un autre niveau efface toute dérogation par utilisateur : il hérite donc initialement de la limite du niveau de destination.

### Retirer un utilisateur d'un niveau

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/tiers/{tier_id}/users/{user_id}
```

Supprime l'attribution explicite de niveau de l'utilisateur (ainsi que toute dérogation). L'utilisateur se voit alors appliquer son niveau mappé au groupe IdP, le cas échéant, ou à défaut le niveau par défaut. Renvoie le code HTTP `204` en cas de réussite.

## Points de terminaison utilisateur

### Obtenir les limites d'un utilisateur

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/users/{user_id}
```

Renvoie le niveau déterminé de l'utilisateur, ses limites et sa requête en attente au sein du budget. Inclut les [champs utilisateur du niveau](#list-a-tiers-users) décrits ci-dessus, ainsi que :

```json theme={null}
{
  "tier_id": "tier-abc123",
  "tier_name": "Engineers",
  "tier_cycle_acu_limit": 500,
  "pending_request_id": null,
  "pending_request_cycle_acu_limit": null
}
```

* `tier_id` / `tier_name` : le niveau dont découle la limite de l'utilisateur (attribution explicite, mise en correspondance de groupe IdP ou niveau par défaut) ; `null` lorsque le budget ne comporte aucun niveau.
* `tier_cycle_acu_limit` : la limite propre au niveau, avant toute dérogation ; `null` signifie que la limite n'est pas plafonnée.
* `pending_request_id` / `pending_request_cycle_acu_limit` : la demande d’augmentation de limite en attente de l'utilisateur et la limite qu'elle demande, le cas échéant.

### Définir ou effacer la dérogation d'un utilisateur

```http theme={null}
PATCH /v3beta1/enterprise/usage-policies/budgets/{budget_id}/users/{user_id}
```

User-scoped : il suffit que la cible soit membre du budget — aucun niveau n'entre en jeu, et l'attribution de niveau de l'utilisateur n'est jamais modifiée.

**Corps de la requête — définir une dérogation temporaire**

```json theme={null}
{
  "cycle_acu_limit": 800,
  "kind": "temporary"
}
```

`kind` est obligatoire pour définir une valeur : `permanent` n'expire jamais ; `temporary` expire à la fin de la période de facturation mensuelle en cours.

**Corps de la requête — effacer toutes les dérogations**

```json theme={null}
{
  "cycle_acu_limit": null
}
```

L'endpoint renvoie le code HTTP `204` en cas de succès.

## Points de terminaison des groupes IdP

Associez un groupe IdP à un niveau afin que ses membres héritent automatiquement de ce niveau. Les mises en correspondance sont déterminées en temps réel à partir de l'appartenance aux groupes et ne modifient jamais l'attribution explicite d'un niveau à un utilisateur : une attribution explicite l'emporte toujours. Lorsqu'un utilisateur appartient à plusieurs groupes mis en correspondance, le niveau retenu est le niveau associé highest-ranked (celui dont la `priority` est la plus élevée ; en cas d'égalité, le niveau le plus récent l'emporte).

### Lister les mises en correspondance de groupes IdP

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups
```

Renvoie une liste paginée des mises en correspondance groupe-niveau du budget, du plus ancien au plus récent. Filtrez avec `?tier_id=` pour ne lister que les groupes mis en correspondance avec un niveau donné :

```json theme={null}
{
  "idp_group_id": "grp_abc123",
  "idp_group_name": "Engineering",
  "tier_id": "tier-abc123"
}
```

### Obtenir la mise en correspondance d'un groupe IdP

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

Renvoie le code HTTP `404` si le groupe n'a aucune mise en correspondance dans le budget.

### Associer un groupe IdP à un niveau

```http theme={null}
PUT /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

**Corps de la requête**

```json theme={null}
{
  "tier_id": "tier-abc123"
}
```

Upsert idempotent. Le niveau doit appartenir au budget. Un groupe ne peut être mappé qu'à un seul niveau par budget : mapper un groupe déjà mappé le déplace donc vers le niveau indiqué.

### Supprimer le mappage d'un groupe IdP

```http theme={null}
DELETE /v3beta1/enterprise/usage-policies/budgets/{budget_id}/idp-groups/{idp_group_name}
```

Renvoie HTTP `204` en cas de réussite. Le niveau associé ne s'applique plus aux membres du groupe ; les utilisateurs sans attribution explicite ni autre niveau associé se voient appliquer le niveau par défaut.

## Points de terminaison des demandes d’augmentation de limite

Les utilisateurs peuvent demander une limite par cycle plus élevée. La `policy` du niveau du demandeur détermine la suite : avec `unconditional` et `conditional`, la demande est approuvée automatiquement jusqu’à la valeur `max_limit` du niveau, tandis qu’avec `manual`, elle reste en attente de revue par un administrateur via ces points de terminaison.

### Lister les demandes d’augmentation de limite

```http theme={null}
GET /v3beta1/enterprise/usage-policies/budgets/{budget_id}/requests
```

Renvoie une liste paginée des demandes associées au budget, filtrable avec `?status=` (`pending`, `approved`, `denied`, `expired`) et `?user_id=` :

```json theme={null}
{
  "request_id": 42,
  "user_id": "user_abc123",
  "name": "Ada Lovelace",
  "email": "ada@example.com",
  "tier_id": "tier-abc123",
  "tier_name": "Engineers",
  "current_cycle_acu_limit": 500,
  "requested_cycle_acu_limit": 800,
  "message": "Wrapping up a large migration this month",
  "status": "pending",
  "created_at": 1735689600,
  "reviewed_at": null,
  "reviewer": null
}
```

* `tier_id` / `tier_name` : le niveau du demandeur au sein du budget ; `null` si le budget ne comporte aucun niveau.
* `current_cycle_acu_limit` : la limite actuellement imposée au demandeur ; `null` signifie qu'elle n'est pas plafonnée.
* `status` : `expired` signifie que la requête était toujours en attente à la fin de son cycle de facturation.
* `reviewer` : l'administrateur qui a examiné la requête ; `null` tant que celle-ci est en attente.

### Obtenir une demande d’augmentation de limite

```http theme={null}
GET /v3beta1/enterprise/usage-policies/requests/{request_id}
```

### Approuver une demande d’augmentation de limite

```http theme={null}
POST /v3beta1/enterprise/usage-policies/requests/{request_id}/approve
```

Accorde la limite demandée sous forme de **dérogation temporaire**, qui expire à la fin de la période de facturation mensuelle en cours. Vous pouvez facultativement accorder une limite différente :

```json theme={null}
{
  "cycle_acu_limit": 700
}
```

Renvoie la requête mise à jour. Renvoie le code HTTP `409` si la requête a déjà été examinée ou si le demandeur n'est plus membre du compte.

### Refuser une demande d’augmentation de limite

```http theme={null}
POST /v3beta1/enterprise/usage-policies/requests/{request_id}/deny
```

Renvoie la requête mise à jour, ou une erreur HTTP `409` si elle a déjà été examinée.

## Exemples de workflows

### Configurer les niveaux d'un budget

Recherchez le budget, plafonnez-le à 2 000 ACU par mois, puis créez un niveau par défaut afin que chaque membre du budget bénéficie d'un plafond mensuel de 500 ACU :

```bash theme={null}
curl "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets" \
  -H "Authorization: Bearer <token>"

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 2000}'

curl -X POST "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/tiers" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Standard", "cycle_acu_limit": 500, "policy": "manual"}'
```

Mappez un groupe IdP au niveau et accordez temporairement à un utilisateur une rallonge jusqu'à la fin du mois :

```bash theme={null}
curl -X PUT "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/idp-groups/Engineering" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"tier_id": "tier-abc123"}'

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/usage-policies/budgets/budget-abc123/users/user_abc123" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 800, "kind": "temporary"}'
```


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