Spend Limits API
Lege für jedes Claude Enterprise-Mitglied ein Ausgabenlimit fest, sieh nach, woher das Ausgabenlimit jedes Mitglieds vererbt wird, und prüfe oder bearbeite Anfragen von Mitgliedern nach einem höheren Limit.
Mit der Spend Limits API kannst du für jedes Claude Enterprise-Mitglied ein „spend limit“ (Ausgabenlimit) festlegen, nachsehen, woher das Ausgabenlimit jedes Mitglieds vererbt wird, und Anfragen von Mitgliedern nach einem höheren Limit prüfen oder bearbeiten.
Für nutzerbezogene und zeitlich gruppierte Berichte zu Nutzung und Kosten siehe Analytics APIs.
Überblick
Die API stellt acht Endpunkte über zwei Ressourcen hinweg bereit:
| Ressource | Endpunkte | Verwendung für |
|---|---|---|
| Ausgabenlimits | GET /v1/organizations/spend_limits/effectiveGET /v1/organizations/spend_limits/{spend_limit_id}POST /v1/organizations/spend_limitsDELETE /v1/organizations/spend_limits/{spend_limit_id} | Das effektive Ausgabenlimit und die bisherigen Ausgaben im laufenden Zeitraum jedes Mitglieds lesen; eine nutzerbezogene Überschreibung setzen oder entfernen. |
| Anfragen zur Erhöhung des Ausgabenlimits | GET /v1/organizations/spend_limit_increase_requestsGET /v1/organizations/spend_limit_increase_requests/{id}POST /v1/organizations/spend_limit_increase_requests/{id}/approvePOST /v1/organizations/spend_limit_increase_requests/{id}/deny | Anfragen von Mitgliedern nach einem höheren Ausgabenlimit auflisten, mit dem für die Entscheidung nötigen Kontext; jede Anfrage genehmigen oder ablehnen. |
Verwende die Endpunkte für Ausgabenlimits, um die Frage „Welches Ausgabenlimit gilt für jedes Mitglied, woher kommt es und wie nah ist das Mitglied daran?“ zu beantworten und um eine nutzerbezogene Überschreibung zu setzen. Verwende die Endpunkte für Anfragen zur Erhöhung des Ausgabenlimits, um die Warteschlange der von Mitgliedern eingereichten Anfragen abzuarbeiten.
Voraussetzungen
- Deine Organisation muss einen Claude Enterprise-Plan haben.
- Nutzungsguthaben müssen für deine Organisation aktiviert sein. Dein primärer Eigentümer kann sie in den Abrechnungseinstellungen von claude.ai aktivieren.
Schnellstart
Liste das effektive monatliche Ausgabenlimit und die bisherigen Ausgaben im laufenden Zeitraum jedes Mitglieds auf:
curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--header "anthropic-version: 2023-06-01"Wichtige Konzepte
Die Hierarchie der Ausgabenlimits
Für die Ausgaben jedes Mitglieds gilt ein effektives Ausgabenlimit („effective spend limit“), das aus einer Hierarchie von Scope-Ebenen aufgelöst wird. Wenn ein Mitglied keine nutzerbezogene Überschreibung hat, erbt es das Ausgabenlimit, das für seine Gruppe (falls deine Organisation gruppenbasierte Limits verwendet), seine Seat-Stufe oder den organisationsweiten Standard konfiguriert ist. Ein Gruppen-Ausgabenlimit ist ein Standardwert pro Mitglied: Jedes Mitglied, das es erbt, wird anhand seiner eigenen Ausgaben begrenzt, nicht anhand eines gemeinsamen Gruppenbudgets.
Das Lesen von GET /v1/organizations/spend_limits/effective gibt jedes aktuelle Mitglied mit seinem aufgelösten effektiven Ausgabenlimit zurück, dazu, woher dieses Limit aufgelöst wurde (source), sowie seine bisherigen Ausgaben im laufenden Zeitraum. Das Setzen einer nutzerbezogenen Überschreibung mit POST /v1/organizations/spend_limits fixiert ein Mitglied auf ein bestimmtes Ausgabenlimit, unabhängig davon, was es sonst erben würde. Das Löschen der Überschreibung setzt es auf das geerbte Ausgabenlimit zurück (oder lässt es unbegrenzt, falls keines existiert).
Das Feld source in der Zeile jedes Mitglieds gibt an, von welcher Ebene sein Ausgabenlimit aufgelöst wurde: user (eine nutzerbezogene Überschreibung), seat_tier, rbac_group oder organization. Behandle Scope-Typen als offene Menge; überspringe unbekannte Werte, anstatt fehlzuschlagen.
Zeitraum
period ist das wiederkehrende Zeitfenster, über das das Ausgabenlimit durchgesetzt wird und die Ausgaben zurückgesetzt werden. Ein Ausgabenlimit wird durch sein Paar (scope, period) identifiziert. Derzeit ist monthly der einzige unterstützte Zeitraum; monatliche Ausgaben werden um 00:00 UTC am ersten Tag jedes Kalendermonats zurückgesetzt. Behandle period als offene Menge.
Beträge und Währung
Alle Geldwerte sind Strings in Untereinheiten der Abrechnungswährung der Organisation (Cent bei USD). Zum Beispiel steht "50000" für 500,00 USD. Parse den Wert als Dezimalzahl und teile durch 100, um Dollar anzuzeigen; vermeide binäre Gleitkommazahlen bei großen Werten.
amount ist nullable. In der effektiven Zeile eines Mitglieds bedeutet null unbegrenzt (kein Ausgabenlimit) und "0" bedeutet, dass das Mitglied Claude nicht über die im Plan enthaltene Nutzung hinaus verwenden kann. In einer konfigurierten Ausgabenlimit-Zeile (wie von GET /v1/organizations/spend_limits/{id} zurückgegeben) bedeutet null lediglich, dass kein numerisches Ausgabenlimit gesetzt ist; lies die effektive Zeile des Mitglieds, um unbegrenzt von „nur enthaltene Nutzung“ zu unterscheiden.
period_to_date_spend sind die seit Beginn des aktuellen period aufgelaufenen Ausgaben des Mitglieds, im selben Untereinheiten-Format; der Wert kann einen Nachkommaanteil enthalten (zum Beispiel "41280.125"). Er kann als "0" erscheinen, wenn der Ausgabenwert vorübergehend nicht verfügbar ist; behandle ihn als informativ, nicht als transaktional.
Lebenszyklus einer Erhöhungsanfrage
Eine Anfrage zur Erhöhung des Ausgabenlimits („spend limit increase request“) wird erstellt, wenn ein Mitglied in claude.ai auf Request more usage klickt. Anfragen werden nicht über diese API erstellt. Der status einer Anfrage ist einer der folgenden:
| Status | Bedeutung |
|---|---|
pending | Wartet auf eine Admin-Aktion. Die Anfrage enthält normalerweise eine aktuelle spend_summary, sodass du das aktuelle effektive Ausgabenlimit und die bisherigen Ausgaben im laufenden Zeitraum des Mitglieds sehen kannst, während du entscheidest; spend_summary kann null sein, wenn sie nicht berechnet werden konnte. |
approved | Die Anfrage wurde mit Genehmigung abgeschlossen: Entweder hat ein Admin sie ausdrücklich genehmigt, eine andere Admin-Aktion hat das Ausgabenlimit des Mitglieds erhöht, oder der Anthropic-Support hat im Namen der Organisation ein Ausgabenlimit erhöht. spend_summary ist null. |
denied | Ein Admin hat abgelehnt. spend_summary ist null. claude.ai blendet die Anfrage-Schaltfläche dieses Mitglieds für 30 Tage ab resolved_at aus; ein Admin kann das Ausgabenlimit des Mitglieds weiterhin jederzeit direkt erhöhen. |
Sowohl approved als auch denied sind Endzustände. Ein Mitglied hat zu jedem Zeitpunkt höchstens eine pending-Anfrage.
Das Genehmigen mit POST /v1/organizations/spend_limit_increase_requests/{id}/approve schreibt dieselbe nutzerbezogene Ausgabenlimit-Zeile, die auch POST /v1/organizations/spend_limits schreibt. Das direkte Setzen eines Ausgabenlimits überführt eine ausstehende Anfrage nicht in einen anderen Status; verwende den Approve-Endpunkt, um eine Anfrage abzuschließen.
Standardmäßig sendet Anthropic dem Mitglied eine E-Mail, wenn seine Anfrage genehmigt oder abgelehnt wird. Übergib suppress_notification: true beim Genehmigen oder Ablehnen, um diese E-Mail zu unterdrücken (zum Beispiel, wenn dein eigenes System das Mitglied benachrichtigt).
Versionierung
Sende bei jeder Anfrage den Header anthropic-version; die verfügbaren Versionen findest du unter API-Versionen.
Ratenlimits
Alle acht Endpunkte teilen sich ein einziges „rate limit“ (Ratenlimit) pro Organisation 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 opaken Cursor paginiert. Die erste Anfrage gibt bis zu limit Zeilen plus einen next_page-Cursor zurück; übergib diesen Cursor unverändert als Parameter page bei der nächsten Anfrage und wiederhole dies, bis next_page null ist.
Ändere Query-Parameter nicht mitten in einer Sequenz. Cursor sind an die Filter gebunden, die sie ausgegeben haben. Wenn du user_ids[], period[], status[] oder actor_ids[] änderst und einen alten Cursor übergibst, erhältst du einen 400-Fehler mit „cursor does not match current query parameters“. Beginne stattdessen eine neue Sequenz ab der ersten Seite.
Serialisierung von Listenparametern
Listenparameter verwenden die Klammernotation: Wiederhole den Parameternamen mit [] für jeden Wert.
user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPqFehlerantworten
Fehlerantworten folgen der Standardform, die unter Fehler dokumentiert ist. Gib die request_id aus dem Antwort-Body an, wenn du den Support kontaktierst.
Ausgabenlimits
Das effektive Ausgabenlimit jedes Mitglieds auflisten
GET /v1/organizations/spend_limits/effective gibt eine Zeile pro aktuellem Mitglied zurück, die das effektive Ausgabenlimit jedes Mitglieds, dessen source in der Scope-Hierarchie und dessen period_to_date_spend widerspiegelt. Erfordert den Scope read:spend_limits.
Vollständige Parameterdetails und Antwortschemata findest du unter Effektive Ausgabenlimits auflisten in der API-Referenz.
curl "https://api.anthropic.com/v1/organizations/spend_limits/effective?limit=20" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--header "anthropic-version: 2023-06-01"{
"data": [
{
"scope": { "type": "user", "user_id": "user_01AbCdEfGh" },
"actor": {
"type": "user_actor",
"user_id": "user_01AbCdEfGh",
"name": "Jane Smith",
"email_address": "jane@example.com",
"deleted": false
},
"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_..."
}Ein einzelnes Ausgabenlimit abrufen
GET /v1/organizations/spend_limits/{spend_limit_id} gibt ein konfiguriertes Ausgabenlimit anhand seiner ID zurück. Verwende es, um die Zeile zu untersuchen, auf die ein Feld spend_limit_id verwiesen hat. Erfordert den Scope read:spend_limits.
Vollständige Parameterdetails und Antwortschemata findest du unter Ein Ausgabenlimit abrufen in der API-Referenz.
curl "https://api.anthropic.com/v1/organizations/spend_limits/spl_01AbCdEfGhIjKlMnOpQrSt" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--header "anthropic-version: 2023-06-01"Eine nutzerbezogene Überschreibung setzen
POST /v1/organizations/spend_limits setzt eine nutzerbezogene Überschreibung des Ausgabenlimits. Dies ist ein Upsert mit dem Schlüssel (scope, period): Das Setzen eines Limits für einen Nutzer und Zeitraum, für die bereits eines existiert, überschreibt es an Ort und Stelle. Dieser Endpunkt akzeptiert nur scope.type: "user"; Standardwerte auf Seat-Stufen-, Gruppen- und Organisationsebene werden in den claude.ai-Einstellungen konfiguriert. Erfordert den Scope write:spend_limits.
Vollständige Parameterdetails und Antwortschemata findest du unter Ein Ausgabenlimit erstellen in der API-Referenz.
curl --request POST "https://api.anthropic.com/v1/organizations/spend_limits" \
--header "content-type: application/json" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--header "anthropic-version: 2023-06-01" \
--data '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "75000"}'{
"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"
}Eine nutzerbezogene Überschreibung entfernen
DELETE /v1/organizations/spend_limits/{spend_limit_id} entfernt eine nutzerbezogene Überschreibung, woraufhin das Mitglied auf einen etwaigen geerbten Standardwert der Seat-Stufe, Gruppe oder Organisation zurückfällt. Zeilen auf Seat-Stufen-, Gruppen- und Organisationsebene können über diesen Endpunkt nicht gelöscht werden. Erfordert den Scope write:spend_limits.
Vollständige Parameterdetails und Antwortschemata findest du unter Ein Ausgabenlimit löschen in der API-Referenz.
curl --request DELETE "https://api.anthropic.com/v1/organizations/spend_limits/spl_01RsTuVwXyZaBcDeFgHiJk" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--header "anthropic-version: 2023-06-01"Anfragen zur Erhöhung des Ausgabenlimits
Erhöhungsanfragen auflisten
GET /v1/organizations/spend_limit_increase_requests listet Anfragen auf, die neuesten zuerst. Filtere nach status[] (pending, approved, denied) und actor_ids[]. Die Liste schließt Anfragen aus, deren Antragsteller nicht mehr Mitglied der Organisation ist. Erfordert den Scope read:spend_limits.
Vollständige Parameterdetails und Antwortschemata findest du unter Anfragen zur Erhöhung des Ausgabenlimits auflisten in der API-Referenz.
curl --globoff "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=50" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--header "anthropic-version: 2023-06-01"Jede ausstehende Anfrage enthält eine aktuelle spend_summary, die das aktuelle effektive Ausgabenlimit und die bisherigen Ausgaben im laufenden Zeitraum des Antragstellers zeigt – genug, um ohne separate Abfrage zu entscheiden.
Eine einzelne Erhöhungsanfrage abrufen
GET /v1/organizations/spend_limit_increase_requests/{id} gibt eine Anfrage anhand ihrer ID zurück. Erfordert den Scope read:spend_limits.
Vollständige Parameterdetails und Antwortschemata findest du unter Eine Anfrage zur Erhöhung des Ausgabenlimits abrufen in der API-Referenz.
curl "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--header "anthropic-version: 2023-06-01"Eine Erhöhungsanfrage genehmigen
POST /v1/organizations/spend_limit_increase_requests/{id}/approve genehmigt eine ausstehende Anfrage: Es schreibt ein nutzerbezogenes Ausgabenlimit in Höhe des vom Admin angegebenen amount für den Antragsteller und überführt die Anfrage in den Status approved. Die Anfrage enthält keinen angefragten Betrag; du gibst das neue Ausgabenlimit bei der Genehmigung an. Erfordert den Scope write:spend_limits.
Vollständige Parameterdetails und Antwortschemata findest du unter Eine Anfrage zur Erhöhung des Ausgabenlimits genehmigen in der API-Referenz.
curl --request POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/approve" \
--header "content-type: application/json" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--header "anthropic-version: 2023-06-01" \
--data '{"amount": "75000", "suppress_notification": true}'Eine Erhöhungsanfrage ablehnen
POST /v1/organizations/spend_limit_increase_requests/{id}/deny lehnt eine ausstehende Anfrage ab. Idempotent bei denied: Das Ablehnen einer bereits abgelehnten Anfrage gibt 200 mit der bestehenden Ressource zurück. Der Endpunkt weist den Versuch zurück, eine bereits genehmigte Anfrage abzulehnen, damit Automatisierungen einen Wiederholungsversuch von einer widersprüchlichen Entscheidung unterscheiden können. Erfordert den Scope write:spend_limits.
Vollständige Parameterdetails und Antwortschemata findest du unter Eine Anfrage zur Erhöhung des Ausgabenlimits ablehnen in der API-Referenz.
curl --request POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/slir_01AbCdEfGhIjKlMnOpQrSt/deny" \
--header "content-type: application/json" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
--header "anthropic-version: 2023-06-01" \
--data '{"suppress_notification": true}'Beispiel-Workflows
Einige dieser Workflows kombinieren die Spend Limits API mit den Kosten-Endpunkten der Analytics APIs. Die Analytics-Kosten-Endpunkte sind für organisationsweite Ausgabenberichte über einen Datumsbereich konzipiert. GET /spend_limits/effective gibt die Obergrenze zurück, die derzeit für jedes Mitglied gilt. Beginne einen Durchlauf mit Analytics, um herauszufinden, welche Mitglieder du dir ansehen solltest, und lies dann ihre aktuellen Obergrenzen mit /effective.
Spend-Limits-Endpunkte erfordern die spend_limits-Scopes und Analytics-Kosten-Endpunkte erfordern read:analytics; siehe Analytics APIs dazu, wie du den Zugriff bereitstellst. Alle Geldwerte sind bei beiden Dezimal-Strings in Untereinheiten (Cent). Beide APIs paginieren mit einem opaken Cursor. Setze ein explizites limit und blättere durch next_page, bis es null ist, um die gesamte Organisation abzudecken.
Den Prüfprozess für Erhöhungsanfragen automatisieren
Führe einen geplanten Job aus, der ausstehende Anfragen abruft, die Genehmigungsrichtlinie deiner Organisation anwendet und jede Anfrage abschließt.
-
Liste ausstehende Anfragen auf:
cURLcurl --globoff "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests?status[]=pending&limit=100" \ --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \ --header "anthropic-version: 2023-06-01"Jede Anfrage enthält die
actor.user_iddes Antragstellers und eine aktuellespend_summarymit seinem aktuellen effektivenamountundperiod_to_date_spend– genug, um ohne separate Abfrage zu entscheiden. -
Wende deine Richtlinie an. Genehmige zum Beispiel automatisch, wenn der aktuelle
amountdes Mitglieds unter einem Schwellenwert liegt, und leite größere Obergrenzen zur manuellen Prüfung weiter. -
Schließe jede Anfrage ab. Zum Genehmigen gib die neue Obergrenze an:
cURLcurl --request POST "https://api.anthropic.com/v1/organizations/spend_limit_increase_requests/{id}/approve" \ --header "content-type: application/json" \ --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \ --header "anthropic-version: 2023-06-01" \ --data '{"amount": "75000", "suppress_notification": true}'Zum Ablehnen sende stattdessen ein
POSTan.../{id}/deny. Übergibsuppress_notification: true, wenn dein eigenes System den Antragsteller benachrichtigt.
Mitglieder identifizieren, die nahe an ihrem Ausgabenlimit sind
Finde Mitglieder, die sich ihrer Obergrenze nähern, damit du sie erhöhen kannst, bevor sie blockiert werden.
-
Rufe die Ausgaben jedes Mitglieds im laufenden Monat aus der Analytics API ab (eine Zeile pro Mitglied, standardmäßig höchste Ausgaben zuerst):
cURLcurl "https://api.anthropic.com/v1/organizations/analytics/user_cost_report?starting_at=2026-06-01T00:00:00Z&limit=1000" \ --header "x-api-key: $ANALYTICS_API_KEY" \ --header "anthropic-version: 2023-06-01"Jede Zeile enthält
actor.user_id,actor.emailundamount(die Ausgaben des Mitglieds in Cent). Blättere durchnext_page, um die gesamte Organisation abzudecken. -
Rufe für die Mitglieder mit den höchsten Ausgaben (oder alle über einem Dollar-Schwellenwert) die effektiven Obergrenzen in Batches ab:
cURLcurl --globoff "https://api.anthropic.com/v1/organizations/spend_limits/effective?user_ids[]=user_01Ab...&user_ids[]=user_01Cd...&limit=100" \ --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \ --header "anthropic-version: 2023-06-01"Jede Zeile gibt die Obergrenze als
amountzurück (null= unbegrenzt,"0"= nur enthaltene Nutzung) zusammen mitperiod_to_date_spend. -
Berechne für jedes Mitglied mit einer positiven Obergrenze
period_to_date_spend / amountund markiere diejenigen, die bei oder über deinem Schwellenwert liegen (zum Beispiel 80 Prozent). Behandle eine Obergrenze von"0"als bereits am Limit. Es gibt keinen serverseitigen Filter für dieses Verhältnis. -
Handle bei markierten Mitgliedern: Erhöhe die Obergrenze mit
POST /v1/organizations/spend_limits, genehmige eine ausstehende Erhöhungsanfrage, falls eine existiert, oder nimm Kontakt mit dem Mitglied auf.
Mitglieder mit sich schnell ändernder Nutzung finden
Mache Mitglieder sichtbar, deren Ausgaben von Woche zu Woche sprunghaft gestiegen sind.
-
Rufe die täglichen Kosten pro Mitglied für die letzten zwei Wochen aus der Analytics API ab:
cURLcurl "https://api.anthropic.com/v1/organizations/analytics/user_cost_report?starting_at=2026-06-09T00:00:00Z&ending_at=2026-06-23T00:00:00Z&bucket_width=1d&limit=1000" \ --header "x-api-key: $ANALYTICS_API_KEY" \ --header "anthropic-version: 2023-06-01"Wenn
bucket_widthgesetzt ist, umfasst jedes Mitglied eine Zeile pro Tag mit Nutzung; blättere durchnext_page, um die vollständige Reihe jedes Mitglieds zu sammeln. -
Gruppiere die Zeilen nach
actor.user_id. Summiere für jedes Mitglied die letzten sieben Tage und die sieben Tage davor. Markiere Mitglieder, deren letzte Woche die Vorwoche um das von dir gewählte Vielfache übersteigt (zum Beispiel drei). Die Kosten der letzten Tage sind vorläufig und können nach oben korrigiert werden; setze für wiederholbare Vergleicheending_atauf oder vor einen zuvor zurückgegebenendata_refreshed_at(siehe Datenverfügbarkeit und Aktualität). -
Handle bei markierten Mitgliedern: Passe die Obergrenze mit
POST /v1/organizations/spend_limitsan oder nimm Kontakt auf.
Das Ausgabenlimit eines Mitglieds während eines Incidents vorübergehend erhöhen
Gib einem Incident-Responder Spielraum zum Arbeiten, solange ein Incident offen ist: Erhöhe seine Ausgabenobergrenze, wenn der Incident beginnt, und setze sie zurück, nachdem der Incident geschlossen wurde. Knüpfe die Erhöhung an dein Incident-Management-System, zum Beispiel indem du eine aktive Incident-ID verlangst, der das Mitglied zugewiesen ist.
-
Lies die aktuelle Obergrenze des Mitglieds und notiere sie für das Zurücksetzen:
cURLcurl --globoff "https://api.anthropic.com/v1/organizations/spend_limits/effective?user_ids[]=user_01AbCdEfGh&period[]=monthly" \ --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \ --header "anthropic-version: 2023-06-01" -
Erhöhe die Obergrenze:
cURLcurl --request POST "https://api.anthropic.com/v1/organizations/spend_limits" \ --header "content-type: application/json" \ --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \ --header "anthropic-version: 2023-06-01" \ --data '{"scope": {"type": "user", "user_id": "user_01AbCdEfGh"}, "amount": "500000", "period": "monthly"}' -
Wenn Responder während eines Incidents breiteren Zugriff benötigen, stelle vorab eine Incident-Responder-Gruppe bereit, deren benutzerdefinierte Rolle diesen gewährt, und füge das Mitglied für die Dauer hinzu:
cURLcurl --request POST "https://api.anthropic.com/v1/organizations/rbac_groups/rbac_group_01UvWxYzAbCdEfGhIjKlMn/members" \ --header "content-type: application/json" \ --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \ --header "anthropic-version: 2023-06-01" \ --data '{"user_id": "user_01AbCdEfGh"}'Siehe Benutzerverwaltung für die Gruppen-Endpunkte.
-
Wenn dein Incident-System den Incident als geschlossen markiert, setze beide Änderungen zurück: Stelle das in Schritt 1 notierte Ausgabenlimit wieder her (oder lösche die Überschreibung mit
DELETE /v1/organizations/spend_limits/{spend_limit_id}, falls das Mitglied keine hatte), und entferne das Mitglied mitDELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}aus der Gruppe.
Häufig gestellte Fragen
Schließt das direkte Setzen eines Ausgabenlimits die ausstehende Erhöhungsanfrage eines Mitglieds ab?
Nein. POST /v1/organizations/spend_limits schreibt die Überschreibung, lässt die ausstehende Anfrage aber unberührt. Verwende POST /v1/organizations/spend_limit_increase_requests/{id}/approve, um die Anfrage abzuschließen und die Überschreibung in einem einzigen Aufruf zu schreiben.
Was passiert, wenn ich eine nutzerbezogene Überschreibung lösche?
Das Mitglied fällt auf das zurück, was es aus der Hierarchie erben würde: den Standardwert seiner Gruppe, Seat-Stufe oder Organisation. Wenn auf keiner Ebene ein Standardwert existiert, ist das Mitglied unbegrenzt.
Kann ich über diese API einen Standardwert für eine Seat-Stufe oder die gesamte Organisation setzen?
Nein. Über diese API können nur nutzerbezogene Überschreibungen geschrieben werden. Standardwerte auf Seat-Stufen-, Gruppen- und Organisationsebene werden in den Organisationseinstellungen von claude.ai konfiguriert.
Warum erscheint period_to_date_spend bei einem aktiven Mitglied manchmal als "0"?
Der Ausgabenwert kann vorübergehend nicht verfügbar sein; in diesem Fall zeigt das Feld "0" an, anstatt einen Fehler auszugeben. Behandle ihn als informativ.
Siehe auch
Generierte Anfrage- und Antwortschemata für jeden Endpunkt der Spend Limits API.
Generierte Anfrage- und Antwortschemata für die Endpunkte für Erhöhungsanfragen.
Nutzerbezogene und zeitlich gruppierte Berichte zu Nutzung und Kosten für Claude Enterprise.
Was this page helpful?