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 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 für jedes Mitglied; 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`	Listet die Anfragen der Mitglieder für ein höheres Limit mit dem erforderlichen Kontext auf, um eine Entscheidung zu treffen; 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.

Erstellen Sie einen Admin API-Schlüssel für Ihre Claude Enterprise-Organisation

Melden Sie sich als Primary Owner an—Nur der Primary Owner Ihrer Claude Enterprise-Mutterorganisation kann diese Schlüssel erstellen.
Öffnen Sie API-Einstellungen—Gehen Sie zu Organisationseinstellungen > API und suchen Sie den Abschnitt Schlüssel.
Klicken und Schlüssel erstellen—Benennen Sie den Schlüssel und wählen Sie die benötigten Bereiche aus der Tabelle der Bereiche. Sie können Bereiche aus verschiedenen APIs (z. B. read:analytics und read:spend_limits) auf einem einzelnen Schlüssel kombinieren.
Kopieren und speichern Sie das Geheimnis—Kopieren Sie das angezeigte Geheimnis (beginnend mit sk-ant-api01-) und speichern Sie es in Ihrem Secrets Manager. Das vollständige Geheimnis wird nur einmal angezeigt.

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 der 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-Zeichenfolge 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	Fehlender `x-api-key`-Header.
403	API-Schlüssel fehlt der erforderliche 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.

Fehlertexte 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 aufgelöst wird. Wenn ein Mitglied keine Außerkraftsetzung pro Benutzer hat, erbt es das für seine Sitzebene 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, wobei dieses Limit aufgelöst wurde von (source), und ihre Ausgaben bis zum aktuellen 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 Sitzebenen-Standard. `seat_tier`-Werte sind vollständig qualifizierte Bezeichner wie `enterprise_standard` oder `enterprise_tier_1`; weitere Werte können hinzugefügt werden.
`rbac_group`	`rbac_group_id`	Ein Gruppen-Standard, 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). Beispielsweise 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 Anfrage zur Ausgabenlimiterhöhung

Eine Anfrage zur Ausgabenlimiterhöhung 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 Ausgaben bis zum aktuellen Zeitraum des Mitglieds sehen können, während Sie entscheiden. `spend_summary` kann `null` sein, wenn es nicht berechnet werden konnte. Behandeln Sie diesen Fall daher.
`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 Sitzebenen-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 Anforderungsschaltfläche dieses Mitglieds 30 Tage lang ab `resolved_at`; ein Admin kann das Limit des Mitglieds jederzeit direkt erhöhen.

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

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

Standardmäßig sendet Anthropic eine E-Mail an das Mitglied, wenn seine Anfrage genehmigt oder abgelehnt wird. Übergeben Sie suppress_notification: true beim Genehmigen oder Ablehnen, 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 zuerst festgelegt wurde.
`updated_at`	string (RFC 3339)	Wann dieses Limit zuletzt geändert wurde.
`scope`	Scope	Die Ebene, auf der dieses Limit geschrieben ist. Siehe den Abschnitt "Scope".
`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 Fenster, über das `amount` erzwungen wird. Siehe den Abschnitt "Period".

Das SpendSummary-Objekt

Eine berechnete Berichtzeile pro Mitglied: das effektive Limit des Mitglieds, woher es stammt, und seine 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`	Scope (`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	Der Zeitraum des Ausgabenlimits, zu dem `source` aufgelöst wurde. Siehe den Abschnitt "Period".
`Quelle`	Umfang	Wo `amount` in der Hierarchie aufgelöst wurde. Entspricht `scope`, wenn das Mitglied eine Außerkraftsetzung pro Benutzer hat.
`spend_limit_id`	Zeichenkette	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`	Zeichenkette	Die Nutzungsguthaben des Mitglieds, die seit Beginn des aktuellen `period` aufgelaufen sind, 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`	Zeichenkette	Immer `"spend_limit_increase_request"`.
`id`	Zeichenkette	Mit Präfix `slir_`.
`created_at`	Zeichenkette (RFC 3339)	Wann das Mitglied die Anfrage eingereicht hat.
`status`	Zeichenkette	`pending`, `approved` oder `denied`.
`resolved_at`	Zeichenkette (RFC 3339) oder null	Wann die Anfrage genehmigt oder abgelehnt wurde. `null` während der Bearbeitung.
`resolved_by`	Actor oder null	Wer die Anfrage genehmigt oder abgelehnt hat: entweder ein `user_actor` (ein Administrator hat in claude.ai gehandelt) oder ein `scoped_api_key_actor` (über diese API aufgelöst). Wenn eine Anfrage durch eine Administratoraktion 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 Administrators. `null` während der Bearbeitung, wenn das Konto des auflösenden Administrators inzwischen gelöscht wurde, oder wenn die Anfrage vom 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`	Zeichenkette	`user_actor` oder `scoped_api_key_actor`.
`user_id`	Zeichenkette	Vorhanden auf `user_actor`. Die Benutzer-ID; derselbe Wert wird von `actor_ids[]` akzeptiert.
`name`	Zeichenkette 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-Adresse 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 Benutzer-Override 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`	opaque cursor string	Nein	—	Der `next_page` Wert aus einer vorherigen Antwort.

Antwortfelder

Feld	Typ	Beschreibung
`data`	array of SpendSummary	Ein Eintrag pro Mitglied, sortiert nach dem Beitrittsdatum des Mitglieds zur Organisation (neueste zuerst).
`next_page`	string oder null	Opaque 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: invalid cursor`
`page` Cursor stimmt nicht mit aktuellem `user_ids[]` überein	400	`page: cursor does not match current query parameters`
`page` Cursor aus einer anderen API-Version	400	`page: cursor was issued by a different API version`
Organisation ist nicht in einem Enterprise-Plan	400	`this endpoint is not supported for this organization type`
Nutzungsguthaben-Abrechnung nicht aktiviert	400	`overage billing is not enabled for this organization`

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`	string	Mit `spl_` vorangestellt.

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	`this endpoint is not supported for this organization type`
Nutzungsguthaben-Abrechnung nicht aktiviert	400	`overage billing is not enabled for this organization`

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. Standardwerte auf Seat-Tier-, Gruppen- und Organisationsebene werden in den claude.ai-Einstellungen konfiguriert.

Das direkte Festlegen eines Ausgabenlimits führt nicht zu einem Übergang einer 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 Dezimalzeichenkette. `"0"` deaktiviert Nutzungsguthaben für das Mitglied. `null` entfernt das Limit (unbegrenzt).
`period`	String	Nein	Standard `"monthly"`. Siehe 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	`Überschussabrechnung 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 (Sitztier, Gruppe oder Organisationsstandardwert) zurückfällt. Sitztier-, 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 Außerkraftsetzung pro Benutzer 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. Anfragen zur Erhöhung auflisten

GET /v1/organizations/spend_limit_increase_requests

Listet Anfragen zur Erhöhung auf, neueste zuerst. Anfragen, deren Anforderer kein Mitglied der Organisation mehr ist, werden 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[]`	string	Nein	alle	Nach Anforderer filtern. Akzeptiert `user_...` IDs.
`limit`	integer 1–1000	Nein	20	Zeilen pro Seite.
`page`	opaque cursor string	Nein	—	Der `next_page`-Wert aus einer vorherigen Antwort.

Antwortfelder

Feld	Typ	Beschreibung
`data`	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	`invalid page cursor format` oder `invalid page cursor`
`page` Cursor stimmt nicht mit aktuellem `status[]` oder `actor_ids[]` überein	400	`page cursor does not match current query parameters`
`page` Cursor aus einer anderen API-Version	400	`page cursor was issued by a different API version; restart pagination`
Organisation ist nicht in einem Enterprise-Plan	400	`this endpoint is not supported for this organization type`
Nutzungsguthaben-Abrechnung nicht aktiviert	400	`overage billing is not enabled for this organization`

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 Antragsteller ist kein Mitglied dieser Organisation mehr	404
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. Erhöhungsanfrage genehmigen

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 Antragsteller und versetzt die Anfrage in den Status approved. Die Anfrage enthält keinen angeforderten Betrag; der Administrator gibt das neue Limit bei der Genehmigung an.

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 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 Anfragsteller 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 hat keinen 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