ACU-Limits auf Organisationsebene

ACU-Limits auf Organisationsebene begrenzen die gesamte einer Organisation zugeordnete ACU-Nutzung je Produktkategorie:

Limit	Abgedeckte Produkte
Local Agent (`local_agent`)	Devin Desktop, Windsurf JetBrains, Devin CLI
Devin (`cloud_agent`)	Devin-Cloud-Sitzungen (Web-App, Slack, andere Schnittstellen)

Jede Organisation in einem Enterprise kann eigene Limits haben, sodass Administratoren Budgets auf Teams oder Projekte verteilen können. Devin-Limits auf Organisationsebene können Sie auch über die Web-App verwalten; siehe Enterprise-Abrechnung. ACU-Limits auf Organisationsebene gelten unabhängig von Limits auf Nutzerebene – eine Anfrage wird blockiert, wenn eines der beiden Limits erreicht ist. Informationen zur Authentifizierung, zu Berechtigungen und zur PATCH-Semantik, die für alle Endpunkte auf dieser Seite gelten, finden Sie unter ACU-Limits.

Zuordnung der Abrechnungsorganisation

Die Local-Agent-Nutzung jedes Nutzers wird einer Abrechnungsorganisation zugerechnet. Diese bestimmt, welches Local-Agent-Limit der Organisation gilt. Die Abrechnungsorganisation wird in folgender Reihenfolge ermittelt:

Explizite Zuweisung: Ein Administrator setzt billing_org_id über die API in den ACU-Settings des Nutzers.
Automatische Ermittlung: Wenn keine explizite Zuweisung vorliegt, wird die erste Organisation verwendet, auf die der Nutzer über eine direkte Mitgliedschaft oder eine Gruppenzuweisung durch einen Identity Provider zugreifen kann.

Die primäre Abrechnungsorganisation eines Nutzers bestimmt auch, welche Local-Agent-Kontrollen für ihn gelten. Explizite Zuweisungen von Abrechnungsorganisationen werden über die veralteten Nutzer-Endpunkte verwaltet – das Feld billing_org_id ist dort nicht veraltet, nur das Limit-Feld:

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"}}'

Organisationsendpunkte

Limits einer Organisation abrufen

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

Response-Body

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

Ein Agent-Block wird ausgelassen, wenn für diese Produktkategorie kein Limit festgelegt ist.

Limits einer Organisation aktualisieren

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

Request-Body – Limits für Local Agent und Devin festlegen

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

Request-Body – nur das Limit für den Local Agent löschen Setzen Sie local_agent auf null, ohne das Devin-Limit zu ändern:

{
  "local_agent": null
}

Der Endpunkt gibt bei Erfolg HTTP 204 zurück.

Limits einer Organisation löschen

Dadurch werden die Limits für Local Agent und Devin der Organisation zurückgesetzt.

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

Der Endpunkt gibt bei Erfolg HTTP 204 zurück.

Beispiel-Workflows

Limits für Local Agents auf Organisationsebene einrichten

Legen Sie ein Budget für die kombinierte Nutzung von Devin Desktop, Windsurf JetBrains und Devin CLI auf Organisationsebene fest:

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}}'

Devin-Limits auf Organisationsebene einrichten

Legen Sie für eine Organisation ein Budget für Devin-Cloud-Sitzungen fest:

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}}'

Häufig gestellte Fragen

Was ist die Zuordnung zur Abrechnungsorganisation?

Die Zuordnung zur Abrechnungsorganisation bestimmt, auf das Limit welcher Organisation die Nutzung von Devin Desktop, Windsurf JetBrains und Devin CLI durch einen Nutzer angerechnet wird. Wenn sie nicht ausdrücklich festgelegt ist, wird automatisch die erste Organisation verwendet, auf die der Nutzer zugreifen kann.

Was passiert, wenn eine Organisation ein Limit erreicht?

Neue Arbeit an Produkten dieser Kategorie wird für die Nutzer der Organisation blockiert — Local-Agent-Produkte beim Limit local_agent, Devin Cloud-Sitzungen beim Limit cloud_agent — bis das Limit angepasst wird oder die Nutzung im nächsten Zeitfenster zurückgesetzt wird.

Devin Desktop

Agent Command Center

Releases

Windsurf Plugins

Accounts

Security

ACU-Limits auf Organisationsebene

Zuordnung der Abrechnungsorganisation

Organisationsendpunkte

Limits einer Organisation abrufen

Limits einer Organisation aktualisieren

Limits einer Organisation löschen

Beispiel-Workflows

Limits für Local Agents auf Organisationsebene einrichten

Devin-Limits auf Organisationsebene einrichten

Häufig gestellte Fragen

​Zuordnung der Abrechnungsorganisation

​Organisationsendpunkte

​Limits einer Organisation abrufen

​Limits einer Organisation aktualisieren

​Limits einer Organisation löschen

​Beispiel-Workflows

​Limits für Local Agents auf Organisationsebene einrichten

​Devin-Limits auf Organisationsebene einrichten

​Häufig gestellte Fragen

Zuordnung der Abrechnungsorganisation

Organisationsendpunkte

Limits einer Organisation abrufen

Limits einer Organisation aktualisieren

Limits einer Organisation löschen

Beispiel-Workflows

Limits für Local Agents auf Organisationsebene einrichten

Devin-Limits auf Organisationsebene einrichten

Häufig gestellte Fragen