ACU-Limits auf Organisationsebene

Ein Limit auf Organisationsebene begrenzt den monatlichen ACU-Verbrauch der Organisation über Cloud-Devin-Sitzungen, Devin Review, Devin Desktop, Windsurf JetBrains und Devin CLI hinweg. Jede Organisation innerhalb eines Enterprise kann ihr eigenes Limit haben, sodass Administratoren Budgets auf Teams oder Projekte verteilen können. Verwalten Sie das Limit unter Settings > Organizations (siehe Enterprise-Billing) oder über die nachfolgend beschriebene API. Das Limit gilt für den Gesamtverbrauch im aktuellen monatlichen Zeitfenster. Zum Beispiel verbleiben bei einem Limit von 5.000 ACUs und bereits verbrauchten 3.000 ACUs noch 2.000 ACUs für die Organisation. Eine Änderung des Limits setzt die Nutzung nicht zurück. Limits auf Organisationsebene und Limits auf Nutzerebene werden unabhängig voneinander durchgesetzt. Neue Arbeit wird blockiert, sobald entweder das Limit des Nutzers oder das Limit der betreffenden Organisation erreicht ist.

Zuordnung der Abrechnungsorganisation

Die Nutzung wird auf das Limit der Organisation angerechnet, der sie in Rechnung gestellt wird:

Cloud-Devin-Sitzungen werden der Organisation zugerechnet, in der die Sitzung läuft.
Devin Review wird der Abrechnungsorganisation des Reviews zugerechnet.
Devin Desktop, Windsurf JetBrains und Devin CLI werden der Abrechnungsorganisation des Nutzers zugerechnet.

Administratoren können die Abrechnungsorganisation eines Nutzers unter Settings > Members oder über die API zuweisen. Ohne explizite Zuweisung wird die erste Organisation ermittelt, auf die der Nutzer über eine direkte Mitgliedschaft oder eine Gruppenzuweisung durch einen Identity Provider zugreifen kann. Die Abrechnungsorganisation eines Nutzers bestimmt auch, welche Local-Agent-Kontrollen für ihn gelten. Um eine Abrechnungsorganisation über die API zuzuweisen, verwenden Sie den Endpunkt für Nutzer-Settings. Dessen Feld billing_org_id wird weiterhin unterstützt:

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

Organization-Endpunkte

Verwenden Sie https://api.devin.ai als Base URL. Informationen zu Authentifizierung und Permissions finden Sie unter ACU-Limits.

Diese Endpunkte befinden sich in der Beta-Phase (/v3beta1) und sind nicht in der veröffentlichten OpenAPI-Spezifikation enthalten.

Limits einer Organisation abrufen

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

Gibt HTTP 200 mit dem Limit der Organisation in cycle_acu_limit zurück:

{
  "cycle_acu_limit": 5000
}

cycle_acu_limit wird ausgelassen, wenn kein Organisationslimit festgelegt ist.

Antworten können auch die veralteten Felder cloud_agent und local_agent enthalten. Verwenden Sie in neuen Integrationen cycle_acu_limit.

Limits einer Organisation aktualisieren

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

Request-Body – ein Limit festlegen

{
  "cycle_acu_limit": 5000
}

Request-Body – das Limit entfernen

{
  "cycle_acu_limit": null
}

`cycle_acu_limit`	Wirkung
Positive Ganzzahl	Legt das gesamte ACU-Budget der Organisation für jedes monatliche Zeitfenster fest
`0`	Blockiert neue Nutzung für die Organisation
`null`	Entfernt das Limit der Organisation
Weggelassen	Lässt das Limit unverändert

Der Endpunkt gibt bei Erfolg HTTP 204 No Content zurück. Verwenden Sie cycle_acu_limit und einen der veralteten Agent-Blocks nicht im selben Request.

Limits einer Organisation löschen

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

Entfernt das ACU-Limit der Organisation – gleichbedeutend damit, cycle_acu_limit auf null zu setzen. Der Endpunkt gibt bei Erfolg HTTP 204 No Content zurück. Wird das Limit einer Organisation entfernt, bleiben Limits auf Nutzerebene und die Abrechnungsbedingungen Ihres Enterprise weiterhin wirksam.

Fehler

Status	Bedeutung
`400`	Eine `PATCH`-Anfrage kombiniert `cycle_acu_limit` mit `cloud_agent` oder `local_agent`
`403`	Dem Token fehlt die erforderliche Berechtigung
`404`	Die Organisation wurde in Ihrem Enterprise nicht gefunden
`409`	`cycle_acu_limit` ist für diese Organisation nicht verfügbar; wenden Sie sich an Ihr Account-Team
`422`	Ungültiger Anfragewert; `cycle_acu_limit` muss eine nicht negative Ganzzahl oder `null` sein

Beispiel: Budget für eine Organisation festlegen

Legen Sie für eine Organisation ein ACU-Limit von 5.000 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 '{"cycle_acu_limit": 5000}'

Häufig gestellte Fragen

Was passiert, wenn eine Organisation ein Limit erreicht?

Neue Arbeit, die dieser Organisation in Rechnung gestellt wird, wird blockiert, bis ein Administrator das Limit erhöht oder entfernt oder die Nutzung im nächsten monatlichen Zeitfenster zurückgesetzt wird.

Wie schnell werden Änderungen an Limits wirksam?

Rechnen Sie mit etwa fünf Minuten, bis Änderungen produktübergreifend wirksam werden. Änderungen an Limits werden im Enterprise-Audit-Log erfasst.

Devin Desktop

Agent Command Center

Releases

Windsurf Plugins

Accounts

Security

ACU-Limits auf Organisationsebene

Zuordnung der Abrechnungsorganisation

Organization-Endpunkte

Limits einer Organisation abrufen

Limits einer Organisation aktualisieren

Limits einer Organisation löschen

Fehler

Beispiel: Budget für eine Organisation festlegen

Häufig gestellte Fragen

​Zuordnung der Abrechnungsorganisation

​Organization-Endpunkte

​Limits einer Organisation abrufen

​Limits einer Organisation aktualisieren

​Limits einer Organisation löschen

​Fehler

​Beispiel: Budget für eine Organisation festlegen

​Häufig gestellte Fragen

Zuordnung der Abrechnungsorganisation

Organization-Endpunkte

Limits einer Organisation abrufen

Limits einer Organisation aktualisieren

Limits einer Organisation löschen

Fehler

Beispiel: Budget für eine Organisation festlegen

Häufig gestellte Fragen