Claude Enterprise Admin API Referenzhandbuch

Dieses Handbuch behandelt Ausgabenlimits und Anfragen zur Erhöhung von Ausgabenlimits für Ihre Claude Enterprise-Organisation mit der Claude Enterprise Admin API. Mit Ausgabenlimits können Sie die Ausgaben für Nutzungsguthaben jedes Mitglieds über einen wiederkehrenden Zeitraum begrenzen, sehen, von wo das Limit jedes Mitglieds vererbt wird, und überprüfen oder bearbeiten Sie Anfragen von Mitgliedern für ein höheres Limit.

Für Berichte zur Nutzung und Kosten pro Benutzer und zeitgestaffelt siehe das Claude Enterprise Analytics API Referenzhandbuch.

Claude Enterprise Admin API befindet sich derzeit in der öffentlichen Beta und ist für Organisationen mit Enterprise-Plänen und aktivierten Nutzungsguthaben verfügbar.

Übersicht

Es gibt acht Endpunkte über zwei Ressourcen:

Ressource	Endpunkte	Verwendung für
Ausgabenlimits	`GET /v1/organizations/spend_limits/effective` `GET /v1/organizations/spend_limits/{spend_limit_id}` `POST /v1/organizations/spend_limits` `DELETE /v1/organizations/spend_limits/{spend_limit_id}`	Lesen Sie das effektive Limit und die Ausgaben bis zum aktuellen Zeitraum jedes Mitglieds; legen Sie eine Außerkraftsetzung pro Benutzer fest oder löschen Sie sie.
Anfragen zur Erhöhung von Ausgabenlimits	`GET /v1/organizations/spend_limit_increase_requests` `GET /v1/organizations/spend_limit_increase_requests/{id}` `POST /v1/organizations/spend_limit_increase_requests/{id}/approve` `POST /v1/organizations/spend_limit_increase_requests/{id}/deny`	Listen Sie die Anfragen der Mitglieder für ein höheres Limit mit dem erforderlichen Kontext auf, um zu entscheiden; genehmigen oder lehnen Sie jede Anfrage ab.

Verwenden Sie die Ausgabenlimits-Endpunkte, um zu beantworten: „Welches Limit gilt für jedes Mitglied, woher kommt es und wie nah sind sie daran?

Voraussetzungen und Authentifizierung

Ihre Organisation muss einen Claude Enterprise-Plan haben.
Nutzungsguthaben müssen für Ihre Organisation aktiviert sein. Ihr Primary Owner kann dies unter Abrechnungseinstellungen in Claude aktivieren.
Der Primary Owner muss einen Admin API-Schlüssel mit einem oder beiden der folgenden Bereiche erstellen:
- read:spend_limits (erforderlich für alle GET-Endpunkte)
- write:spend_limits (erforderlich für POST- und DELETE-Endpunkte)

Übergeben Sie den Schlüssel im x-api-key-Header bei jeder Anfrage.

Wichtig: Geben Sie API-Schlüssel nicht öffentlich frei und checken Sie sie nicht in die Quellcodeverwaltung ein.

Basis-URL

https://api.anthropic.com

Ratenbegrenzung

Alle acht Endpunkte teilen sich ein einzelnes organisationsweites Limit von 60 Anfragen pro Minute. Anfragen über dem Limit geben 429 Too Many Requests zurück.

Paginierung

GET /v1/organizations/spend_limits/effective und GET /v1/organizations/spend_limit_increase_requests werden mit einem undurchsichtigen Cursor paginiert. Die erste Anfrage gibt bis zu limit Zeilen plus einen next_page-Cursor zurück. Übergeben Sie diesen Cursor unverändert als page-Parameter bei der nächsten Anfrage und wiederholen Sie dies, bis next_page null ist.

Wichtig: Ändern Sie Abfrageparameter nicht während einer Sequenz. Cursor sind an die Filter gebunden, die sie ausgegeben haben. Wenn Sie user_ids[], status[] oder actor_ids[] ändern und einen alten Cursor übergeben, erhalten Sie einen 400-Fehler mit „cursor does not match current query parameters". Starten Sie stattdessen eine neue Sequenz von der ersten Seite."

Behandeln Sie die Cursor-Zeichenkette als undurchsichtig: analysieren, ändern oder konstruieren Sie sie nicht selbst.

Serialisierung von Listenparametern

Listenparameter verwenden Klammernotation: wiederholen Sie den Parameternamen mit [] für jeden Wert.

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq

Fehlerantworten

Status	Bedeutung
400	Ungültige Eingabe, nicht unterstützter Parameterwert, Seiten-Cursor stimmt nicht mit aktuellen Parametern überein, oder eine Vorbedingung ist nicht erfüllt (siehe Validierungen pro Endpunkt).
401	`x-api-key`-Header fehlt.
403	API-Schlüssel hat nicht den erforderlichen Bereich (`read:spend_limits` oder `write:spend_limits`).
404	Ressource nicht gefunden, oder API-Schlüssel ist unbekannt, abgelaufen oder widerrufen.
429	Ratenlimit überschritten.
500	Interner Fehler.

Fehler-Bodies haben die folgende Form:

{"type": "error", "error": {"type": "<error_type>", "message": "..."}, "request_id": "req_..."}

error.type ist ein statusabhängiger Diskriminator: invalid_request_error (400), authentication_error (401), permission_error (403), not_found_error (404), rate_limit_error (429), api_error (500). request_id ist immer vorhanden und ist der Wert, den Sie beim Kontakt mit dem Support angeben sollten. Die Validierungstabelle unter jedem Endpunkt listet die spezifischen Meldungen auf.

Konzepte

Die Ausgabenlimit-Hierarchie

Die Ausgabenausgaben jedes Mitglieds werden durch ein effektives Ausgabenlimit begrenzt, das aus einer Hierarchie von Bereichsebenen ermittelt wird. Wenn ein Mitglied keine Außerkraftsetzung pro Benutzer hat, erbt es das für seine Seat-Tier konfigurierte Limit, sein Limit für seine Gruppe (falls Ihre Organisation gruppenbasierte Limits verwendet) oder den organisationsweiten Standard.

Das Lesen von GET /v1/organizations/spend_limits/effective gibt alle aktuellen Mitglieder mit ihrem aufgelösten effektiven Limit zurück, von wo aus dieses Limit aufgelöst wurde (source), und ihre bisherige Ausgabe in diesem Zeitraum. Das Festlegen einer Außerkraftsetzung pro Benutzer über POST /v1/organizations/spend_limits bindet ein Mitglied an ein bestimmtes Limit, unabhängig davon, was es sonst erben würde. Das Löschen der Außerkraftsetzung gibt es an das geerbte Limit zurück.

Bereich

Ein Bereich identifiziert die Ebene, auf der ein Ausgabenlimit geschrieben oder aufgelöst wird:

Typ	Felder	Bedeutung
`user`	`user_id`	Ein bestimmtes Mitglied. `user_id` entspricht den IDs, die von den Admin-API-Benutzerendpunkten zurückgegeben werden.
`seat_tier`	`seat_tier`	Ein Seat-Tier-Standard. `seat_tier`-Werte sind vollständig qualifizierte Bezeichner wie `enterprise_standard` oder `enterprise_tier_1`; es können weitere Werte hinzugefügt werden.
`rbac_group`	`rbac_group_id`	Ein Gruppenstandard, wenn Ihre Organisation Limits nach Gruppe verwaltet.
`organization`	—	Der organisationsweite Standard.

scope.type ist eine offene Zeichenkette. Clients sollten unbekannte Werte als undurchsichtig behandeln und durchfallen, anstatt zu fehlschlagen. Zusätzliche Bereichstypen können in Zukunft hinzugefügt werden.

Zeitraum

period ist das wiederkehrende Fenster, über das das Limit durchgesetzt wird und die Ausgaben zurückgesetzt werden. Der einzige Wert heute ist "monthly".

period ist eine offene Zeichenkette. Clients sollten unbekannte Werte als undurchsichtig behandeln und durchfallen, anstatt zu fehlschlagen. Zusätzliche Periodenwerte können in Zukunft hinzugefügt werden.

Beträge und Währung

Alle Geldwerte sind Zeichenketten in Untereinheiten der Abrechnungswährung der Organisation (Cent für USD). Zum Beispiel stellt "50000" 500,00 USD dar. Analysieren Sie als Dezimalzahl und dividieren Sie durch 100, um Dollar anzuzeigen. Vermeiden Sie binäre Gleitkommazahlen für große Werte.

amount ist nullable: null bedeutet unbegrenzt (kein Limit). "0" bedeutet, dass Nutzungsguthaben für dieses Mitglied deaktiviert sind.

period_to_date_spend ist das Nutzungsguthaben des Mitglieds, das seit Beginn des aktuellen period anfallen ist, im gleichen Format der Untereinheit. Es kann einen Bruchteil enthalten (z. B. "41280.125").

Lebenszyklus der Ausgabenlimit-Anfrage

Eine Anfrage zur Erhöhung des Ausgabenlimits wird erstellt, wenn ein Mitglied in claude.ai auf „Mehr Nutzung anfordern" klickt. Anfragen werden nicht über diese API erstellt."

Status	Bedeutung
`pending`	Wartet auf Admin-Aktion. Die Anfrage enthält normalerweise eine Live-`spend_summary`, damit Sie das aktuelle effektive Limit und die bisherige Ausgabe des Mitglieds in diesem Zeitraum sehen können, während Sie entscheiden. `spend_summary` kann `null` sein, wenn es nicht berechnet werden konnte. Behandeln Sie diesen Fall.
`approved`	Die Anfrage wurde mit Genehmigung gelöst: Entweder hat ein Admin sie explizit genehmigt (Schreiben eines Ausgabenlimits pro Benutzer mit dem vom Admin bereitgestellten Betrag), eine andere Admin-Aktion hat Nutzungsguthaben für das Mitglied verfügbar gemacht (z. B. Erhöhung eines Seat-Tier-Limits oder Aktivierung der Nutzungsguthaben-Abrechnung für die Organisation), oder der Anthropic-Support hat ein Limit im Namen der Organisation erhöht. `spend_summary` ist `null`.
`denied`	Ein Admin hat abgelehnt. `spend_summary` ist `null`. Claude.ai verbirgt die Anfrage-Schaltfläche dieses Mitglieds für 30 Tage ab `resolved_at`; ein Admin kann das Limit des Mitglieds jederzeit direkt erhöhen.

Sowohl approved als auch denied sind terminal. Ein Mitglied hat höchstens eine pending-Anfrage gleichzeitig.

Das Genehmigen über POST …/approve schreibt die gleiche Ausgabenlimit-Zeile pro Benutzer, die POST /v1/organizations/spend_limits schreibt. Das direkte Festlegen eines Ausgabenlimits führt nicht zu einer Übergangspending-Anfrage. Verwenden Sie den Genehmigungsendpunkt, um eine Anfrage zu lösen.

Standardmäßig sendet Anthropic dem Mitglied eine E-Mail, wenn seine Anfrage genehmigt oder abgelehnt wird. Übergeben Sie suppress_notification: true bei Genehmigung oder Ablehnung, um diese E-Mail zu unterdrücken (z. B. wenn Ihr eigenes System das Mitglied benachrichtigt).

Das SpendLimit-Objekt

Ein konfiguriertes Limit auf einer Bereichsebene.

{
  "type": "spend_limit",
  "id": "spl_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-01T12:00:00Z",
  "updated_at": "2026-05-03T09:14:11Z",
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "50000",
  "currency": "USD",
  "period": "monthly"
}

Feld	Typ	Beschreibung
`type`	string	Immer `"spend_limit"`.
`id`	string	Mit Präfix `spl_`.
`created_at`	string (RFC 3339)	Wann dieses Limit erstmals festgelegt wurde.
`updated_at`	string (RFC 3339)	Wann dieses Limit zuletzt geändert wurde.
`scope`	Bereich	Die Ebene, auf der dieses Limit festgelegt ist. Siehe den Abschnitt "Bereich".
`amount`	string oder null	Limit für den `period`, in Kleineinheiten. `null` bedeutet unbegrenzt.
`currency`	string	ISO 4217. Die Abrechnungswährung der Organisation.
`period`	string	Das wiederkehrende Zeitfenster, über das `amount` durchgesetzt wird. Siehe den Abschnitt "Periode".

Das SpendSummary-Objekt

Ein berechneter Berichtszeileneintrag pro Mitglied: das effektive Limit des Mitglieds, dessen Herkunft und die Ausgaben bis zum aktuellen Zeitraum. Keine adressierbare Ressource (kein id).

{
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "50000",
  "currency": "USD",
  "period": "monthly",
  "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
  "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
  "period_to_date_spend": "31402.5"
}

Feld	Typ	Beschreibung
`scope`	Bereich (`type: "user"`)	Das Mitglied, für das diese Zeile gilt.
`amount`	string oder null	Das effektive Limit für den `period`, in Kleineinheiten. `null` bedeutet unbegrenzt; `"0"` bedeutet, dass Nutzungsguthaben deaktiviert sind.
`currency`	string	ISO 4217.
`period`	string	Die Periode des Ausgabenlimits, zu dem `source` aufgelöst wurde. Siehe den Abschnitt "Periode".
`source`	Bereich	Wo `amount` in der Hierarchie aufgelöst wurde. Entspricht `scope`, wenn das Mitglied eine Außerkraftsetzung pro Benutzer hat.
`spend_limit_id`	string	ID des `SpendLimit`, zu dem `source` aufgelöst wurde. Rufen Sie es mit `GET /v1/organizations/spend_limits/{spend_limit_id}` ab.
`period_to_date_spend`	string	Die Nutzungsguthaben des Mitglieds, die seit Beginn des aktuellen `period` angesammelt wurden, in Kleineinheiten.

Das SpendLimitIncreaseRequest-Objekt

{
  "type": "spend_limit_increase_request",
  "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-04T16:22:09Z",
  "status": "pending",
  "resolved_at": null,
  "resolved_by": null,
  "actor": {
    "type": "user_actor",
    "user_id": "user_01AbCdEfGh",
    "name": "Jane Smith",
    "email_address": "[email protected]"
  },
  "spend_summary": {
    "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
    "amount": "50000",
    "currency": "USD",
    "period": "monthly",
    "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
    "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
    "period_to_date_spend": "48900"
  }
}

Feld	Typ	Beschreibung
`type`	string	Immer `"spend_limit_increase_request"`.
`id`	string	Mit Präfix `slir_`.
`created_at`	string (RFC 3339)	Zeitpunkt der Anfrageeingabe durch das Mitglied.
`status`	string	`pending`, `approved` oder `denied`.
`resolved_at`	string (RFC 3339) oder null	Zeitpunkt der Genehmigung oder Ablehnung der Anfrage. `null` während der Bearbeitung.
`resolved_by`	Actor oder null	Wer die Anfrage genehmigt oder abgelehnt hat: entweder ein `user_actor` (ein Admin hat in claude.ai gehandelt) oder ein `scoped_api_key_actor` (über diese API aufgelöst). Wenn eine Anfrage durch eine Admin-Aktion in claude.ai automatisch aufgelöst wird (z. B. durch Erhöhung eines Seat-Tier-Limits, Aktivierung der Nutzungsguthaben-Abrechnung für die Organisation oder Erhöhung des Limits des Mitglieds), ist `resolved_by` der `user_actor` des handelnden Admins. `null` während der Bearbeitung, wenn das Konto des auflösenden Admins inzwischen gelöscht wurde, oder wenn die Anfrage durch den Anthropic-Support aufgelöst wurde. Ein `scoped_api_key_actor` kann auf einen Schlüssel verweisen, der inzwischen gelöscht oder widerrufen wurde. Behandeln Sie `scoped_api_key_id` als historische Referenz und tolerieren Sie Lookup-Fehler.
`actor`	Actor (`user_actor`)	Das Mitglied, das die Anfrage eingereicht hat.
`spend_summary`	SpendSummary oder null	Live-Entscheidungskontext für den Anfragenden: sein effektives Limit und die Ausgaben bis zum aktuellen Datum. Vorhanden, während `status` ausstehend ist (kann `null` sein, wenn die Zusammenfassung nicht berechnet werden konnte); immer `null` nach Auflösung.

Actor

Feld	Typ	Beschreibung
`type`	string	`user_actor` oder `scoped_api_key_actor`.
`user_id`	string	Vorhanden auf `user_actor`. Die Benutzer-ID; derselbe Wert wird von `actor_ids[]` akzeptiert.
`name`	string oder null	Vorhanden auf `user_actor`. Der Name des Benutzers; `null`, wenn das Konto gelöscht wurde oder der Benutzer keinen Namen festgelegt hat.
`email_address`	string oder null	Vorhanden auf `user_actor`. Die E-Mail des Benutzers; `null`, wenn das Konto gelöscht wurde.
`scoped_api_key_id`	string	Vorhanden auf `scoped_api_key_actor`. Mit Präfix `apikey_`.

Ausgabenlimits

1. Effektive Ausgabenlimits auflisten

GET /v1/organizations/spend_limits/effective

Gibt alle aktuellen Mitglieder der Organisation mit ihrem aufgelösten effektiven Limit und dem Ausgabensaldo für den aktuellen Zeitraum zurück. Mitglieder ohne Außerkraftsetzung pro Benutzer werden mit source.type von seat_tier, rbac_group oder organization angezeigt. Ehemalige Mitglieder werden nicht aufgelistet.

Erforderlicher Bereich: read:spend_limits.

Abfrageparameter

Feld	Typ	Erforderlich	Standard	Beschreibung
`user_ids[]`	String, max. 100 Einträge	Nein	alle Mitglieder	Eingrenzen auf bestimmte Mitglieder. Akzeptiert `user_...` IDs. Ein Eintrag, der kein aktuelles Mitglied ist, wird stillschweigend aus `data` weggelassen.
`limit`	Integer 1–1000	Nein	20	Zeilen pro Seite.
`page`	undurchsichtige Cursor-Zeichenkette	Nein	—	Der `next_page` Wert aus einer vorherigen Antwort.

Antwortfelder

Feld	Typ	Beschreibung
`data`	Array von SpendSummary	Ein Eintrag pro Mitglied, sortiert nach dem Beitrittsdatum des Mitglieds zur Organisation (neueste zuerst).
`next_page`	String oder null	Undurchsichtiger Cursor für die nächste Seite; `null` wenn keine weiteren Seiten vorhanden sind.

Beispielanfrage

curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Beispielantwort

{
  "data": [
    {
      "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
      "amount": "50000",
      "currency": "USD",
      "period": "monthly",
      "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
      "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
      "period_to_date_spend": "31402.5"
    }
  ],
  "next_page": "page_..."
}

Validierungen

Bedingung	Status	Nachricht
`user_ids[]` Eintrag fehlerhaft	400	`user_ids[]: entry is not a valid user ID`
`user_ids[]` hat mehr als 100 Einträge	400
`limit` außerhalb von 1–1000	400
`page` Cursor ungültig	400	`page: ungültiger Cursor`
`page` Cursor stimmt nicht mit aktuellem `user_ids[]` überein	400	`page: Cursor stimmt nicht mit aktuellen Abfrageparametern überein`
`page` Cursor aus einer anderen API-Version	400	`page: Cursor wurde von einer anderen API-Version ausgestellt`
Organisation ist nicht in einem Enterprise-Plan	400	`dieser Endpunkt wird für diesen Organisationstyp nicht unterstützt`
Nutzungsguthaben-Abrechnung nicht aktiviert	400	`Überschreitungsabrechnung ist für diese Organisation nicht aktiviert`

2. Ausgabenlimit abrufen

GET /v1/organizations/spend_limits/{spend_limit_id}

Gibt ein einzelnes Ausgabenlimit nach ID zurück. Verwenden Sie dies, um die Zeile zu überprüfen, auf die ein SpendSummary.spend_limit_id oder eine POST-Antwort verweist.

Erforderlicher Bereich: read:spend_limits.

Pfadparameter

Feld	Typ	Beschreibung
`spend_limit_id`	Zeichenkette	Mit Präfix `spl_`.

Antwort

Ein SpendLimit-Objekt.

Beispielanfrage

curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Validierungen

Bedingung	Status	Nachricht
`spend_limit_id` nicht in dieser Organisation gefunden	404
Organisation ist nicht in einem Enterprise-Plan	400	`dieser Endpunkt wird für diesen Organisationstyp nicht unterstützt`
Nutzungsguthaben-Abrechnung nicht aktiviert	400	`Überschreitungsabrechnung ist für diese Organisation nicht aktiviert`

3. Ausgabenlimit festlegen

POST /v1/organizations/spend_limits

Legt eine pro-Benutzer Ausgabenlimit-Überschreibung fest. Upsert: Das Festlegen eines Limits für einen Benutzer, der bereits eines hat, überschreibt es an Ort und Stelle.

Nur scope.type: "user" wird akzeptiert. Sitzplatz-Tier-, Gruppen- und Standardwerte auf Organisationsebene werden in den claude.ai-Einstellungen konfiguriert.

Das direkte Festlegen eines Ausgabenlimits führt nicht zu einer Umwandlung der ausstehenden Erhöhungsanfrage eines Mitglieds. Verwenden Sie den Genehmigungsendpunkt, um eine Anfrage zu lösen.

Erforderlicher Bereich: write:spend_limits.

Anfragekörper

Feld	Typ	Erforderlich	Beschreibung
`scope`	Objekt	Ja	`{ "type": "user", "user_id": "user_..." }`.
`amount`	String oder null	Ja	Neues Limit für den `period`, in Kleineinheiten, als nicht-negative Ganzzahl-Dezimalzeichenkette. `"0"` deaktiviert Nutzungsguthaben für das Mitglied. `null` entfernt das Limit (unbegrenzt).
`period`	String	Nein	Standard `"monthly"`. Siehe den Abschnitt „Period"."

Antwort

Ein SpendLimit-Objekt, das die geschriebene Außerkraftsetzung widerspiegelt.

Beispielanfrage

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limits" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'

Beispielantwort

{
  "type": "spend_limit",
  "id": "spl_01RsTuVwXyZaBcDeFgHiJk",
  "created_at": "2026-05-11T10:02:44Z",
  "updated_at": "2026-05-11T10:02:44Z",
  "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
  "amount": "75000",
  "currency": "USD",
  "period": "monthly"
}

Validierungen

Bedingung	Status	Nachricht
`scope.type` ist nicht `"user"`	400	`scope.type: noch nicht unterstützt`
`scope.user_id` fehlerhaft	400	`scope.user_id: fehlerhaft`
`scope.user_id` ist kein Mitglied dieser Organisation	400	`scope.user_id: kein Mitglied dieser Organisation`
`amount` negativ, gebrochen oder keine gültige Dezimalzeichenkette	400
`period` ist nicht `"monthly"`	400	`period: noch nicht unterstützt`
Organisation ist nicht in einem Enterprise-Plan	400	`dieser Endpunkt wird für diesen Organisationstyp nicht unterstützt`
Nutzungsguthaben-Abrechnung nicht aktiviert	400	`Überschreitungsabrechnung ist für diese Organisation nicht aktiviert`

4. Ausgabenlimit entfernen

DELETE /v1/organizations/spend_limits/{spend_limit_id}

Entfernt eine Pro-Benutzer-Außerkraftsetzung, sodass das Mitglied auf das vererbte Limit (Seat-Tier, Gruppe oder Organisationsstandardwert) zurückfällt. Seat-Tier-, Gruppen- und Organisationsebenen-Zeilen können über diesen Endpunkt nicht gelöscht werden.

Erfordert Bereich: write:spend_limits.

Pfadparameter

Feld	Typ	Beschreibung
`spend_limit_id`	String	Mit Präfix `spl_`. Muss die ID einer Pro-Benutzer-Außerkraftsetzung sein.

Antwort

{ "type": "spend_limit_deleted", "id": "spl_01RsTuVwXyZaBcDeFgHiJk" }

Beispielanfrage

curl -X DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Validierungen

Bedingung	Status	Nachricht
`spend_limit_id` nicht in dieser Organisation gefunden	404
`spend_limit_id` ist eine Sitz-Ebene, Gruppe oder Organisationszeile	400	`Nur Ausgabenlimits pro Benutzer können über diesen Endpunkt gelöscht werden.`
Organisation ist nicht in einem Enterprise-Plan	400	`dieser Endpunkt wird für diesen Organisationstyp nicht unterstützt`
Nutzungsguthaben-Abrechnung nicht aktiviert	400	`Überschreitungsabrechnung ist für diese Organisation nicht aktiviert`

Anfragen zur Erhöhung des Ausgabenlimits

5. Erhöhungsanfragen auflisten

GET /v1/organizations/spend_limit_increase_requests

Listet Erhöhungsanfragen auf, neueste zuerst. Anfragen, deren Anforderer kein Mitglied der Organisation mehr ist, sind ausgeschlossen.

Erforderlicher Bereich: read:spend_limits.

Abfrageparameter

Feld	Typ	Erforderlich	Standard	Beschreibung
`status[]`	eines oder mehrere von `pending`, `approved`, `denied`	Nein	alle	Nach Status filtern. Wiederholen Sie den Parameter für mehrere Werte.
`actor_ids[]`	Zeichenkette	Nein	alle	Nach Anforderer filtern. Akzeptiert `user_...` IDs.
`limit`	Ganzzahl 1–1000	Nein	20	Zeilen pro Seite.
`page`	undurchsichtige Cursor-Zeichenkette	Nein	—	Der `next_page`-Wert aus einer vorherigen Antwort.

Antwortfelder

Feld	Typ	Beschreibung
`Daten`	Array von SpendLimitIncreaseRequest	Sortiert nach `created_at` absteigend.
`next_page`	String oder null	Undurchsichtiger Cursor für die nächste Seite; `null` wenn keine weiteren Seiten vorhanden sind.

Beispielanfrage

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Beispielantwort

{
  "data": [
    {
      "type": "spend_limit_increase_request",
      "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
      "created_at": "2026-05-04T16:22:09Z",
      "status": "pending",
      "resolved_at": null,
      "resolved_by": null,
      "actor": {
        "type": "user_actor",
        "user_id": "user_01AbCdEfGh",
        "name": "Jane Smith",
        "email_address": "[email protected]"
      },
      "spend_summary": {
        "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
        "amount": "50000",
        "currency": "USD",
        "period": "monthly",
        "source": { "type": "seat_tier", "seat_tier": "enterprise_standard" },
        "spend_limit_id": "spl_01XyZaBcDeFgHiJkLmNoPq",
        "period_to_date_spend": "48900"
      }
    }
  ],
  "next_page": null
}

Validierungen

Bedingung	Status	Nachricht
`actor_ids[]` Eintrag fehlerhaft	400	`actor_ids[]: ungültige gekennzeichnete Benutzer-ID`
`limit` außerhalb von 1–1000	400
`page` Cursor fehlerhaft	400	`ungültiges Seitenformat des Cursors` oder `ungültiger Seitencursor`
`page` Cursor stimmt nicht mit aktuellem `status[]` oder `actor_ids[]` überein	400	`Seitencursor stimmt nicht mit aktuellen Abfrageparametern überein`
`page` Cursor aus einer anderen API-Version	400	`Seitencursor wurde von einer anderen API-Version ausgestellt; Paginierung neu starten`
Organisation ist nicht in einem Enterprise-Plan	400	`dieser Endpunkt wird für diesen Organisationstyp nicht unterstützt`
Nutzungsguthaben-Abrechnung nicht aktiviert	400	`Überschreitungsabrechnung ist für diese Organisation nicht aktiviert`

6. Erhöhungsanfrage abrufen

GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Gibt eine einzelne Erhöhungsanfrage zurück.

Erforderlicher Bereich: read:spend_limits.

Pfadparameter

Feld	Typ	Beschreibung
`spend_limit_increase_request_id`	String	Mit Präfix `slir_`.

Antwort

Ein SpendLimitIncreaseRequest-Objekt.

Beispielanfrage

curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

Validierungen

Bedingung	Status	Nachricht
Anfrage in dieser Organisation nicht gefunden	404
Der Anforderer ist kein Mitglied dieser Organisation mehr	404
Die Organisation hat keinen Enterprise-Plan	400	`dieser Endpunkt wird für diesen Organisationstyp nicht unterstützt`
Nutzungsguthaben-Abrechnung nicht aktiviert	400	`Überschreitungsabrechnung ist für diese Organisation nicht aktiviert`

7. Genehmigen Sie eine Erhöhungsanfrage

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Genehmigt eine ausstehende Anfrage. Schreibt ein Ausgabenlimit pro Benutzer unter amount für den Anforderer und überführt die Anfrage in den Status approved. Wenn die Anfrage keinen angeforderten Betrag enthält, stellt der Administrator das neue Limit bei der Genehmigung bereit.

Erforderlicher Bereich: write:spend_limits.

Pfadparameter

Feld	Typ	Beschreibung
`spend_limit_increase_request_id`	Zeichenkette	Mit Präfix `slir_`.

Anfragekörper

Feld	Typ	Erforderlich	Standard	Beschreibung
`amount`	Zeichenkette	Ja	—	Neues Ausgabenlimit pro Benutzer für den `period`, in Kleineinheiten, als nicht-negative Ganzzahl-Dezimalzeichenkette.
`period`	Zeichenkette	Nein	`"monthly"`	Siehe den Abschnitt "Zeitraum".
`suppress_notification`	Boolesch	Nein	`false`	Wenn `true`, sendet Anthropic keine E-Mail an das Mitglied, dass seine Anfrage genehmigt wurde.

Antwort

Die SpendLimitIncreaseRequest mit Status approved, mit einem zusätzlichen spend_limit-Feld, das das geschriebene SpendLimit enthält.

Beispielanfrage

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"amount": "75000", "suppress_notification": true}'

Beispielantwort

{
  "type": "spend_limit_increase_request",
  "id": "slir_01AbCdEfGhIjKlMnOpQrSt",
  "created_at": "2026-05-04T16:22:09Z",
  "status": "approved",
  "resolved_at": "2026-05-11T10:05:02Z",
  "resolved_by": {
    "type": "scoped_api_key_actor",
    "scoped_api_key_id": "apikey_01ZyXwVuTsRqPoNmLkJiHg"
  },
  "actor": {
    "type": "user_actor",
    "user_id": "user_01AbCdEfGh",
    "name": "Jane Smith",
    "email_address": "[email protected]"
  },
  "spend_summary": null,
  "spend_limit": {
    "type": "spend_limit",
    "id": "spl_01RsTuVwXyZaBcDeFgHiJk",
    "created_at": "2026-05-11T10:05:02Z",
    "updated_at": "2026-05-11T10:05:02Z",
    "scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
    "amount": "75000",
    "currency": "USD",
    "period": "monthly"
  }
}

Validierungen

Bedingung	Status	Nachricht
Anfrage in dieser Organisation nicht gefunden	404
Der Anforderer ist kein Mitglied dieser Organisation mehr	404
Anfrage bereits `genehmigt` oder `abgelehnt`	400	`Anfrage zur Erhöhung des Ausgabenlimits ist bereits gelöst`
`Betrag` negativ, gebrochen oder keine gültige Dezimalzeichenkette	400
`Zeitraum` ist nicht `"monatlich"`	400	`Zeitraum: noch nicht unterstützt`
Organisation hat keinen Enterprise-Plan	400	`dieser Endpunkt wird für diesen Organisationstyp nicht unterstützt`
Nutzungsguthaben-Abrechnung nicht aktiviert	400	`Überschreitungsabrechnung ist für diese Organisation nicht aktiviert`

8. Erhöhungsanfrage ablehnen

POST /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Lehnt eine ausstehende Anfrage ab. Idempotent bei abgelehnt: Das Ablehnen einer bereits abgelehnten Anfrage gibt 200 mit der vorhandenen Ressource zurück. Das Ablehnen einer bereits genehmigten Anfrage wird abgelehnt, damit die Automatisierung einen Wiederholungsversuch von einer widersprüchlichen Entscheidung unterscheiden kann.

Erfordert Bereich: write:spend_limits.

Pfadparameter

Feld	Typ	Beschreibung
`spend_limit_increase_request_id`	Zeichenkette	Mit Präfix `slir_`.

Anfragekörper

Feld	Typ	Erforderlich	Standard	Beschreibung
`suppress_notification`	boolescher Wert	Nein	`falsch`	Wenn `wahr`, sendet Anthropic keine E-Mail an das Mitglied, dass seine Anfrage abgelehnt wurde.

Antwort

Eine SpendLimitIncreaseRequest mit Status abgelehnt.

Beispielanfrage

curl -X POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "content-type: application/json" \
  -d '{"suppress_notification": true}'

Validierungen

Bedingung	Status	Nachricht
Anfrage in dieser Organisation nicht gefunden	404
Der Anforderer ist kein Mitglied dieser Organisation mehr	404
Anfrage bereits `genehmigt`	400	`Anfrage zur Erhöhung des Ausgabenlimits ist bereits genehmigt`
Anfrage bereits `abgelehnt`	— (200, idempotent)
Organisation ist nicht in einem Enterprise-Plan	400	`dieser Endpunkt wird für diesen Organisationstyp nicht unterstützt`
Nutzungsguthaben nicht aktiviert	400	`Überschreitungsabrechnung ist für diese Organisation nicht aktiviert`

Verwandte Artikel

Ich habe eine Claude Console-Organisation erstellt – wie beginne ich mit der Verwendung der Claude API?

Wie kann ich meine Claude API-Nutzung auf Tier 2 erhöhen?

Zusätzliche Nutzung für Team- und Seat-basierte Enterprise-Pläne verwalten

Claude Enterprise Analytics API-Referenzhandbuch

Verwalten Sie Gruppen und Ausgabenlimits für Gruppen in Enterprise-Plänen