Limites d’ACU au niveau de l’organisation

Une limite au niveau de l’organisation plafonne la consommation mensuelle d’ACU de l’organisation sur l’ensemble des sessions cloud Devin, de Devin Review, Devin Desktop, Windsurf JetBrains et Devin CLI. Chaque organisation d’une enterprise peut disposer de sa propre limite, ce qui permet aux administrateurs de répartir les budgets entre les teams ou les projets. Gérez la limite dans Settings > Organizations (voir Billing enterprise) ou via l’API ci-dessous. La limite s’applique à la consommation totale de la période de facturation mensuelle en cours. Par exemple, avec une limite de 5 000 ACU et 3 000 ACU déjà consommés, il reste 2 000 ACU à l’organisation. Modifier la limite ne réinitialise pas l’utilisation. Les limites au niveau de l’organisation et les limites au niveau de l’utilisateur s’appliquent indépendamment les unes des autres. Tout nouveau travail est bloqué dès que la limite de l’utilisateur ou celle de l’organisation concernée est atteinte.

Attribution à l’organisation de facturation

L’utilisation est imputée à la limite de l’organisation à laquelle elle est facturée :

Les sessions cloud Devin sont imputées à l’organisation dans laquelle la session s’exécute.
Devin Review est imputé à l’organisation de facturation de la review.
Devin Desktop, Windsurf JetBrains et Devin CLI sont imputés à l’organisation de facturation de l’utilisateur.

Les administrateurs peuvent attribuer une organisation de facturation à un utilisateur dans Settings > Members ou via l’API. En l’absence d’attribution explicite, elle correspond à la première organisation à laquelle l’utilisateur a accès par adhésion directe ou via l’attribution à un groupe d’un fournisseur d’identité. L’organisation de facturation d’un utilisateur détermine également quels contrôles de l’agent local s’appliquent à cet utilisateur. Pour attribuer une organisation de facturation via l’API, utilisez l’endpoint des Settings utilisateur. Son champ billing_org_id reste pris en charge :

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/users/user_abc123/consumption/acu-limits" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"local_agent": {"billing_org_id": "org-xyz789"}}'

Endpoints d’organisation

Utilisez https://api.devin.ai comme URL de base. Consultez Limites d’ACU pour l’authentification et les autorisations.

Ces endpoints sont en bêta (/v3beta1) et ne figurent pas dans la spécification OpenAPI publiée.

Obtenir les limites d’une organisation

GET /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits

Renvoie un code HTTP 200 avec la limite de l’organisation dans cycle_acu_limit :

{
  "cycle_acu_limit": 5000
}

cycle_acu_limit est omis si aucune limite d’organisation n’est définie.

Les réponses peuvent également inclure les champs cloud_agent et local_agent, qui sont obsolètes. Utilisez cycle_acu_limit dans les nouvelles intégrations.

Mettre à jour les limites d’une organisation

PATCH /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits

Corps de la requête — définir une limite

{
  "cycle_acu_limit": 5000
}

Corps de la requête — supprimer la limite

{
  "cycle_acu_limit": null
}

`cycle_acu_limit`	Effet
Entier positif	Définit le budget total d’ACU de l’organisation pour chaque période de facturation mensuelle
`0`	Bloque toute nouvelle utilisation pour l’organisation
`null`	Supprime la limite de l’organisation
Omis	Laisse la limite inchangée

L’endpoint renvoie le code HTTP 204 No Content en cas de réussite. N’incluez pas cycle_acu_limit et l’un des blocs agent obsolètes dans la même requête.

Supprimer les limites d’une organisation

DELETE /v3beta1/enterprise/organizations/{org_id}/consumption/acu-limits

Supprime la limite d’ACU de l’organisation, ce qui équivaut à définir cycle_acu_limit sur null. L’endpoint renvoie le code HTTP 204 No Content en cas de réussite. La suppression d’une limite d’organisation laisse en vigueur les limites au niveau de l’utilisateur ainsi que les conditions de facturation de votre enterprise.

Erreurs

Statut	Signification
`400`	Une requête `PATCH` combine `cycle_acu_limit` avec `cloud_agent` ou `local_agent`
`403`	Le token ne dispose pas de l’autorisation requise
`404`	L’organisation est introuvable dans votre enterprise
`409`	`cycle_acu_limit` n’est pas disponible pour cette organisation ; contactez votre account team
`422`	Valeur de requête invalide ; `cycle_acu_limit` doit être un entier positif ou nul, ou `null`

Exemple : définir un budget d’organisation

Définissez une limite de 5 000 ACU pour une organisation :

curl -X PATCH "https://api.devin.ai/v3beta1/enterprise/organizations/org-xyz789/consumption/acu-limits" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"cycle_acu_limit": 5000}'

Questions fréquentes

Que se passe-t-il lorsqu'une organisation atteint une limite ?

Tout nouveau travail facturé à cette organisation est bloqué jusqu’à ce qu’un administrateur augmente ou supprime la limite, ou que l’utilisation soit réinitialisée lors de la prochaine période de facturation mensuelle.

Sous quel délai les modifications de limites prennent-elles effet ?

Comptez environ cinq minutes pour que les modifications prennent effet sur l’ensemble des produits. Les modifications de limites sont consignées dans le journal d’audit Enterprise.

​Attribution à l’organisation de facturation

​Endpoints d’organisation

​Obtenir les limites d’une organisation

​Mettre à jour les limites d’une organisation

​Supprimer les limites d’une organisation

​Erreurs

​Exemple : définir un budget d’organisation

​Questions fréquentes

Attribution à l’organisation de facturation

Endpoints d’organisation

Obtenir les limites d’une organisation

Mettre à jour les limites d’une organisation

Supprimer les limites d’une organisation

Erreurs

Exemple : définir un budget d’organisation

Questions fréquentes