Limites d’ACU au niveau de l’organisation

Les limites au niveau de l’organisation plafonnent l’utilisation totale d’ACU attribuée à une organisation, par catégorie de produits :

Limite	Produits concernés
Local Agent (`local_agent`)	Devin Desktop, Windsurf JetBrains, Devin CLI
Devin (`cloud_agent`)	Sessions Devin dans le cloud (application web, Slack, autres interfaces)

Chaque organisation d’une entreprise peut avoir ses propres limites, ce qui permet aux administrateurs de répartir les budgets entre les équipes ou les projets. Vous pouvez également gérer les limites Devin au niveau de l’organisation depuis l’application web ; consultez Billing Enterprise. Les limites au niveau de l’organisation sont indépendantes des limites au niveau de l’utilisateur : une requête est bloquée dès que l’une ou l’autre est atteinte. Consultez Limites d’ACU pour connaître l’authentification, les autorisations et la sémantique de PATCH communes à tous les endpoints de cette page.

Attribution à l’organisation de facturation

L’utilisation de Local Agent de chaque utilisateur est imputée à une organisation de facturation, qui détermine quelle limite Local Agent s’applique. L’organisation de facturation est déterminée dans l’ordre suivant :

Attribution explicite : un administrateur définit billing_org_id dans les Settings ACU de l’utilisateur via l’API.
Détermination automatique : en l’absence d’attribution explicite, 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é est utilisée.

L’organisation de facturation principale d’un utilisateur détermine également quels contrôles de l’agent local s’appliquent à cet utilisateur. Les attributions explicites d’organisation de facturation sont gérées à l’aide des anciens endpoints utilisateur : le champ billing_org_id n’y est pas obsolète ; seul le champ de limite l’est :

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

Obtenir les limites d’une organisation

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

Corps de la réponse

{
  "local_agent": {
    "cycle_acu_limit": 2000
  },
  "cloud_agent": {
    "cycle_acu_limit": 1000
  }
}

Un bloc d’agent est omis si aucune limite n’est définie pour cette catégorie de produits.

Mettre à jour les limites d’une organisation

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

Corps de la requête — définir les limites de Local Agent et de Devin

{
  "local_agent": {
    "cycle_acu_limit": 2000
  },
  "cloud_agent": {
    "cycle_acu_limit": 1000
  }
}

Corps de la requête — réinitialiser uniquement la limite de Local Agent Définissez local_agent sur null sans modifier la limite de Devin :

{
  "local_agent": null
}

L’endpoint renvoie le code HTTP 204 en cas de réussite.

Supprimer les limites d’une organisation

Cette opération supprime les limites Local Agent et Devin de l’organisation.

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

L’endpoint renvoie le code HTTP 204 en cas de réussite.

Exemples de workflows

Configurer des limites Local Agent au niveau de l’organisation

Définissez un budget au niveau de l’organisation pour l’utilisation combinée de Devin Desktop, Windsurf JetBrains et Devin CLI :

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 '{"local_agent": {"cycle_acu_limit": 5000}}'

Configurer les limites Devin au niveau de l’organisation

Définissez un budget de session Devin dans le cloud 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 '{"cloud_agent": {"cycle_acu_limit": 1000}}'

Questions fréquentes

Qu’est-ce que l’attribution à l’organisation de facturation ?

L’attribution à l’organisation de facturation détermine quelle organisation voit la limite Local Agent inclure l’utilisation de Devin Desktop, Windsurf JetBrains et Devin CLI d’un utilisateur. Si elle n’est pas explicitement définie, elle est automatiquement attribuée à la première organisation à laquelle l’utilisateur a accès.

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

Les nouveaux travaux sont bloqués pour les utilisateurs de l’organisation dans les produits de cette catégorie — les produits Local Agent pour la limite local_agent, les sessions Devin dans le cloud pour la limite cloud_agent — jusqu’à ce que la limite soit ajustée ou que l’utilisation soit réinitialisée au cours de la prochaine période mensuelle.

​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

​Exemples de workflows

​Configurer des limites Local Agent au niveau de l’organisation

​Configurer les limites Devin au niveau de l’organisation

​Questions fréquentes