Guida di riferimento dell'API Claude Enterprise Admin

Questa guida copre i limiti di spesa e le richieste di aumento dei limiti di spesa per la tua organizzazione Claude Enterprise utilizzando l'API Claude Enterprise Admin. I limiti di spesa ti permettono di limitare la spesa in crediti di utilizzo di ogni membro in un periodo ricorrente, vedere da dove viene ereditato il limite di ogni membro e rivedere o agire sulle richieste dei membri per un limite più alto.

Per report di utilizzo e costi per utente e con bucket temporali, consulta la guida di riferimento dell'API Claude Enterprise Analytics.

L'API Claude Enterprise Admin è attualmente in beta pubblica ed è disponibile per le organizzazioni con piani Enterprise con crediti di utilizzo abilitati.

Panoramica

Ci sono otto endpoint su due risorse:

Risorsa	Endpoint	Utilizzare per
Limiti di spesa	`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}`	Leggi il limite effettivo di ogni membro e la spesa da inizio periodo; imposta o cancella un override per utente.
Richieste di aumento dei limiti di spesa	`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`	Elenca le richieste dei membri per un limite più alto, con il contesto necessario per decidere; approva o nega ogni richiesta.

Utilizza gli endpoint dei limiti di spesa per rispondere a "Quale limite si applica a ogni membro, da dove viene e quanto sono vicini ad esso?" e per impostare un override per utente. Utilizza gli endpoint delle richieste di aumento dei limiti di spesa per gestire la coda di richieste inviate dai membri.

Prerequisiti e autenticazione

La tua organizzazione deve essere su un piano Claude Enterprise.
I crediti di utilizzo devono essere abilitati per la tua organizzazione. Il tuo Proprietario Principale può abilitare questa opzione in Impostazioni di fatturazione in Claude.
Il Proprietario Principale deve creare una chiave API Admin con uno o entrambi i seguenti ambiti:
- read:spend_limits (obbligatorio per tutti gli endpoint GET)
- write:spend_limits (obbligatorio per gli endpoint POST e DELETE)

Passa la chiave nell'intestazione x-api-key su ogni richiesta.

Importante: Non condividere le chiavi API pubblicamente o inserirle nel controllo del codice sorgente.

URL di base

https://api.anthropic.com

Limitazione della velocità

Tutti gli otto endpoint condividono un singolo limite per organizzazione di 60 richieste al minuto. Le richieste oltre il limite restituiscono 429 Too Many Requests.

Paginazione

GET /v1/organizations/spend_limits/effective e GET /v1/organizations/spend_limit_increase_requests sono paginati con un cursore opaco. La prima richiesta restituisce fino a limit righe più un cursore next_page. Passa quel cursore invariato come parametro page nella richiesta successiva e ripeti fino a quando next_page non è null.

Importante: Non modificare i parametri di query a metà sequenza. I cursori sono legati ai filtri che li hanno emessi. Se modifichi user_ids[], status[] o actor_ids[] e passi un cursore precedente, otterrai un 400 con "cursor does not match current query parameters". Inizia invece una nuova sequenza dalla prima pagina.

Tratta la stringa del cursore come opaca: non analizzarla, modificarla o costruirla da solo.

Serializzazione dei parametri di elenco

I parametri di elenco utilizzano la notazione tra parentesi: ripeti il nome del parametro con [] per ogni valore.

user_ids[]=user_01AbCdEfGh&user_ids[]=user_01JkLmNoPq

Risposte di errore

Stato	Significato
400	Input non valido, valore di parametro non supportato, cursore di pagina non corrisponde ai parametri attuali o una precondizione non è soddisfatta (vedere Validazioni per endpoint).
401	Intestazione `x-api-key` mancante.
403	La chiave API non dispone dell'ambito richiesto (`read:spend_limits` o `write:spend_limits`).
404	Risorsa non trovata, oppure la chiave API è sconosciuta, scaduta o revocata.
429	Limite di frequenza superato.
500	Errore interno.

I corpi degli errori hanno la seguente struttura:

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

error.type è un discriminatore dipendente dallo stato: invalid_request_error (400), authentication_error (401), permission_error (403), not_found_error (404), rate_limit_error (429), api_error (500). request_id è sempre presente ed è il valore da citare quando si contatta il supporto. La tabella Validazioni sotto ogni endpoint elenca i messaggi specifici.

Concetti

La gerarchia dei limiti di spesa

La spesa di crediti di utilizzo di ogni membro è limitata da un limite di spesa effettivo, risolto da una gerarchia di livelli di ambito. Quando un membro non ha un override per utente, eredita il limite configurato per il suo livello di posto, il suo gruppo (se l'organizzazione utilizza limiti basati su gruppi) o l'impostazione predefinita a livello di organizzazione.

La lettura di GET /v1/organizations/spend_limits/effective restituisce ogni membro attuale con il suo limite effettivo risolto, da dove è stato risolto il limite (source) e la sua spesa da inizio periodo. L'impostazione di un override per utente tramite POST /v1/organizations/spend_limits fissa un membro a un limite specifico indipendentemente da ciò che altrimenti erediterebbe. L'eliminazione dell'override lo restituisce al limite ereditato.

Ambito

Un ambito identifica il livello a cui un limite di spesa è scritto o risolto:

Tipo	Campi	Significato
`user`	`user_id`	Un membro specifico. `user_id` corrisponde agli ID restituiti dagli endpoint degli utenti dell'API Admin.
`seat_tier`	`seat_tier`	Un valore predefinito del livello di posto. I valori di `seat_tier` sono identificatori completamente qualificati come `enterprise_standard` o `enterprise_tier_1`; è possibile che vengano aggiunti valori aggiuntivi.
`rbac_group`	`rbac_group_id`	Un valore predefinito del gruppo, quando l'organizzazione gestisce i limiti per gruppo.
`organization`	—	L'impostazione predefinita a livello di organizzazione.

scope.type è una stringa aperta. I client devono trattare i valori sconosciuti come opachi e passare oltre piuttosto che fallire. Ulteriori tipi di ambito potrebbero essere aggiunti in futuro.

Periodo

period è la finestra ricorrente su cui il limite viene applicato e la spesa viene azzerata. L'unico valore attualmente è "monthly".

period è una stringa aperta. I client devono trattare i valori sconosciuti come opachi e passare oltre piuttosto che fallire. Ulteriori valori di periodo potrebbero essere aggiunti in futuro.

Importi e valuta

Tutti i valori monetari sono stringhe in unità minori della valuta di fatturazione dell'organizzazione (centesimi, per USD). Ad esempio, "50000" rappresenta 500,00 USD. Analizzare come decimale e dividere per 100 per visualizzare i dollari. Evitare la virgola mobile binaria per valori grandi.

amount è nullable: null significa illimitato (nessun limite). "0" significa che i crediti di utilizzo sono disabilitati per quel membro.

period_to_date_spend è il credito di utilizzo accumulato dal membro dall'inizio del period attuale, nello stesso formato di unità minore. Può includere una parte frazionaria (ad esempio, "41280.125").

Ciclo di vita della richiesta di aumento del limite di spesa

Una richiesta di aumento del limite di spesa viene creata quando un membro fa clic su "richiedi più utilizzo" in claude.ai. Le richieste non vengono create tramite questa API.

Stato	Significato
`pending`	In attesa di azione dell'amministratore. La richiesta normalmente contiene un `spend_summary` attivo in modo da poter vedere il limite effettivo attuale del membro e la spesa da inizio periodo mentre si decide. `spend_summary` potrebbe essere `null` se non potesse essere calcolato, quindi gestire quel caso.
`approved`	La richiesta è stata risolta con approvazione: un amministratore l'ha approvata esplicitamente (scrivendo un limite di spesa per utente all'importo fornito dall'amministratore), un'altra azione dell'amministratore ha reso disponibili i crediti di utilizzo al membro (ad esempio, aumentando un limite di livello di posto o abilitando la fatturazione dei crediti di utilizzo per l'organizzazione), oppure il supporto di Anthropic ha aumentato un limite per conto dell'organizzazione. `spend_summary` è `null`.
`denied`	Un amministratore ha rifiutato. `spend_summary` è `null`. Claude.ai nasconde il pulsante di richiesta di quel membro per 30 giorni da `resolved_at`; un amministratore può comunque aumentare il limite del membro direttamente in qualsiasi momento.

Sia approved che denied sono terminali. Un membro ha al massimo una richiesta pending alla volta.

L'approvazione tramite POST …/approve scrive la stessa riga di limite di spesa per utente che POST /v1/organizations/spend_limits scrive. L'impostazione di un limite di spesa direttamente non fa transizione a una richiesta in sospeso. Utilizzare l'endpoint di approvazione per risolvere una richiesta.

Per impostazione predefinita, Anthropic invia un'email al membro quando la sua richiesta viene approvata o rifiutata. Passare suppress_notification: true su approvazione o rifiuto per sopprimere quell'email (ad esempio, quando il tuo sistema notifica il membro).

L'oggetto SpendLimit

Un limite configurato a un livello di ambito.

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

Campo	Tipo	Descrizione
`type`	stringa	Sempre `"spend_limit"`.
`id`	stringa	Con prefisso `spl_`.
`created_at`	stringa (RFC 3339)	Quando questo limite è stato impostato per la prima volta.
`updated_at`	stringa (RFC 3339)	Quando questo limite è stato modificato l'ultima volta.
`scope`	Ambito	Il livello a cui è scritto questo limite. Vedi la sezione "Ambito".
`amount`	stringa o null	Limite per il `period`, in unità minori. `null` significa illimitato.
`currency`	stringa	ISO 4217. La valuta di fatturazione dell'organizzazione.
`period`	stringa	La finestra ricorrente su cui `amount` è applicato. Vedi la sezione "Periodo".

L'oggetto SpendSummary

Una riga di report calcolata per membro: il limite effettivo del membro, da dove proviene e la sua spesa da inizio periodo. Non è una risorsa indirizzabile (nessun 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"
}

Campo	Tipo	Descrizione
`scope`	Ambito (`type: "user"`)	Il membro per cui è questa riga.
`amount`	stringa o null	Il limite effettivo per il `period`, in unità minori. `null` significa illimitato; `"0"` significa che i crediti di utilizzo sono disabilitati.
`currency`	stringa	ISO 4217.
`period`	stringa	Il periodo del limite di spesa a cui `source` è stato risolto. Vedi la sezione "Periodo".
`source`	Ambito	Da dove `amount` è stato risolto nella gerarchia. Uguale a `scope` quando il membro ha un override per utente.
`spend_limit_id`	stringa	ID del `SpendLimit` a cui `source` si è risolto. Recuperalo con `GET /v1/organizations/spend_limits/{spend_limit_id}`.
`period_to_date_spend`	stringa	I crediti di utilizzo accumulati dal membro dall'inizio del `period` corrente, in unità minori.

L'oggetto SpendLimitIncreaseRequest

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

Campo	Tipo	Descrizione
`type`	stringa	Sempre `"spend_limit_increase_request"`.
`id`	stringa	Con prefisso `slir_`.
`created_at`	stringa (RFC 3339)	Quando il membro ha inviato la richiesta.
`status`	stringa	`pending`, `approved`, o `denied`.
`resolved_at`	stringa (RFC 3339) o null	Quando la richiesta è stata approvata o rifiutata. `null` mentre in sospeso.
`resolved_by`	Actor o null	Chi ha approvato o rifiutato la richiesta: un `user_actor` (un amministratore ha agito in claude.ai) o un `scoped_api_key_actor` (risolto tramite questa API). Quando una richiesta viene risolta automaticamente da un'azione dell'amministratore in claude.ai (ad esempio, aumentando un limite di livello di posto, abilitando la fatturazione del credito di utilizzo per l'organizzazione o aumentando il limite del membro), `resolved_by` è il `user_actor` dell'amministratore che agisce. `null` mentre in sospeso, quando l'account dell'amministratore risolutore è stato successivamente eliminato, o quando la richiesta è stata risolta dal supporto Anthropic. Un `scoped_api_key_actor` può fare riferimento a una chiave che è stata successivamente eliminata o revocata. Tratta `scoped_api_key_id` come un riferimento storico e tollerare i fallimenti di ricerca.
`actor`	Actor (`user_actor`)	Il membro che ha inviato la richiesta.
`spend_summary`	SpendSummary o null	Contesto decisionale in tempo reale per il richiedente: il suo limite effettivo e la spesa da inizio periodo. Presente mentre `status` è in sospeso (può essere `null` se il riepilogo non poteva essere calcolato); sempre `null` una volta risolto.

Actor

Campo	Tipo	Descrizione
`type`	stringa	`user_actor` o `scoped_api_key_actor`.
`user_id`	stringa	Presente su `user_actor`. L'ID dell'utente; stesso valore accettato da `actor_ids[]`.
`name`	stringa o null	Presente su `user_actor`. Il nome dell'utente; `null` se l'account è stato eliminato o l'utente non ha impostato un nome.
`email_address`	stringa o null	Presente su `user_actor`. L'email dell'utente; `null` se l'account è stato eliminato.
`scoped_api_key_id`	stringa	Presente su `scoped_api_key_actor`. Con prefisso `apikey_`.

Limiti di spesa

1. Elenca i limiti di spesa effettivi

GET /v1/organizations/spend_limits/effective

Restituisce ogni membro attuale dell'organizzazione con il suo limite effettivo risolto e la spesa da inizio periodo. I membri senza un override per utente appaiono con source.type di seat_tier, rbac_group, o organization. Gli ex-membri non sono elencati.

Richiede ambito: read:spend_limits.

Parametri di query

Campo	Tipo	Obbligatorio	Predefinito	Descrizione
`user_ids[]`	stringa, max 100 voci	No	tutti i membri	Restringi a membri specifici. Accetta ID `user_...`. Una voce che non è un membro attuale viene omessa silenziosamente da `data`.
`limit`	intero 1–1000	No	20	Righe per pagina.
`page`	stringa cursore opaca	No	—	Il valore `next_page` da una risposta precedente.

Campi di risposta

Campo	Tipo	Descrizione
`data`	array di SpendSummary	Una voce per membro, ordinata per quando il membro si è unito all'organizzazione (più recente per primo).
`next_page`	stringa o null	Cursore opaco per la pagina successiva; `null` quando non ci sono più pagine.

Richiesta di esempio

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

Risposta di esempio

{
  "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_..."
}

Convalide

Condizione	Stato	Messaggio
Voce `user_ids[]` malformata	400	`user_ids[]: entry is not a valid user ID`
`user_ids[]` ha più di 100 voci	400
`limit` al di fuori di 1–1000	400
Cursore `page` non valido	400	`page: cursore non valido`
`page` cursore non corrisponde all'attuale `user_ids[]`	400	`page: cursore non corrisponde ai parametri di query attuali`
`page` cursore da una versione API diversa	400	`page: cursore emesso da una versione API diversa`
L'organizzazione non è in un piano Enterprise	400	`questo endpoint non è supportato per questo tipo di organizzazione`
Fatturazione con crediti di utilizzo non abilitata	400	`la fatturazione per eccedenza non è abilitata per questa organizzazione`

2. Ottenere un limite di spesa

GET /v1/organizations/spend_limits/{spend_limit_id}

Restituisce un singolo limite di spesa per ID. Utilizzare questo per ispezionare la riga a cui fa riferimento SpendSummary.spend_limit_id o una risposta POST.

Richiede ambito: read:spend_limits.

Parametri del percorso

Campo	Tipo	Descrizione
`spend_limit_id`	stringa	Con prefisso `spl_`.

Risposta

Un oggetto SpendLimit.

Richiesta di esempio

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

Convalide

Condizione	Stato	Messaggio
`spend_limit_id` non trovato in questa organizzazione	404
L'organizzazione non è in un piano Enterprise	400	`questo endpoint non è supportato per questo tipo di organizzazione`
Fatturazione con crediti di utilizzo non abilitata	400	`la fatturazione per eccedenza non è abilitata per questa organizzazione`

3. Impostare un limite di spesa

POST /v1/organizations/spend_limits

Imposta un override del limite di spesa per utente. Upsert: l'impostazione di un limite per un utente che ne ha già uno lo sovrascrive.

Solo scope.type: "user" è accettato. I valori predefiniti a livello di fascia di posti, gruppo e organizzazione sono configurati nelle impostazioni di claude.ai.

L'impostazione di un limite di spesa direttamente non fa passare la richiesta di aumento in sospeso di un membro. Utilizzare l'endpoint di approvazione per risolvere una richiesta.

Richiede ambito: write:spend_limits.

Corpo della richiesta

Campo	Tipo	Obbligatorio	Descrizione
`scope`	oggetto	Sì	`{ "type": "user", "user_id": "user_..." }`.
`amount`	stringa o null	Sì	Nuovo limite per il `period`, in unità minori, come stringa decimale intera non negativa. `"0"` disabilita il credito di utilizzo per il membro. `null` rimuove il limite (illimitato).
`period`	stringa	No	Predefinito `"monthly"`. Vedi la sezione "Period".

Risposta

Un oggetto SpendLimit che riflette l'override scritto.

Richiesta di esempio

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

Risposta di esempio

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

Convalide

Condizione	Stato	Messaggio
`scope.type` non è `"user"`	400	`scope.type: non ancora supportato`
`scope.user_id` malformato	400	`scope.user_id: malformato`
`scope.user_id` non è un membro di questa organizzazione	400	`scope.user_id: non è un membro di questa organizzazione`
`amount` negativo, frazionario o non una stringa decimale valida	400
`period` non è `"monthly"`	400	`period: non ancora supportato`
L'organizzazione non è in un piano Enterprise	400	`questo endpoint non è supportato per questo tipo di organizzazione`
Fatturazione del credito di utilizzo non abilitata	400	`la fatturazione del sovraccarico non è abilitata per questa organizzazione`

4. Rimuovi un limite di spesa

DELETE /v1/organizations/spend_limits/{spend_limit_id}

Rimuove un override per utente in modo che il membro ritorni al limite ereditato (livello di posto, gruppo o predefinito dell'organizzazione). Le righe a livello di posto, gruppo e organizzazione non possono essere eliminate tramite questo endpoint.

Richiede ambito: write:spend_limits.

Parametri del percorso

Campo	Tipo	Descrizione
`spend_limit_id`	stringa	Con prefisso `spl_`. Deve essere l'ID di un override per utente.

Risposta

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

Richiesta di esempio

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

Convalide

Condizione	Stato	Messaggio
`spend_limit_id` non trovato in questa organizzazione	404
`spend_limit_id` è una riga di livello di posto, gruppo o organizzazione	400	`Solo i limiti di spesa per utente possono essere eliminati tramite questo endpoint.`
L'organizzazione non è in un piano Enterprise	400	`questo endpoint non è supportato per questo tipo di organizzazione`
Fatturazione del credito di utilizzo non abilitata	400	`la fatturazione del sovraccarico non è abilitata per questa organizzazione`

Richieste di aumento del limite di spesa

5. Elencare le richieste di aumento

GET /v1/organizations/spend_limit_increase_requests

Elenca le richieste di aumento, le più recenti per prime. Le richieste il cui richiedente non è più membro dell'organizzazione sono escluse.

Richiede ambito: read:spend_limits.

Parametri di query

Campo	Tipo	Obbligatorio	Predefinito	Descrizione
`status[]`	uno o più di `pending`, `approved`, `denied`	No	tutti	Filtra per stato. Ripeti il parametro per più valori.
`actor_ids[]`	stringa	No	tutti	Filtra per richiedente. Accetta ID `user_...`.
`limit`	numero intero 1–1000	No	20	Righe per pagina.
`page`	stringa cursore opaca	No	—	Il valore `next_page` da una risposta precedente.

Campi di risposta

Campo	Tipo	Descrizione
`dati`	array di SpendLimitIncreaseRequest	Ordinato per `created_at` decrescente.
`next_page`	stringa o null	Cursore opaco per la pagina successiva; `null` quando non ci sono altre pagine.

Richiesta di esempio

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

Risposta di esempio

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

Convalide

Condizione	Stato	Messaggio
`actor_ids[]` voce malformata	400	`actor_ids[]: ID utente taggato non valido`
`limit` al di fuori di 1–1000	400
`page` cursore malformato	400	`formato cursore pagina non valido` o `cursore pagina non valido`
`page` cursore non corrisponde a `status[]` o `actor_ids[]` corrente	400	`il cursore della pagina non corrisponde ai parametri di query correnti`
`page` cursore da una versione API diversa	400	`il cursore della pagina è stato emesso da una versione API diversa; riavvia la paginazione`
L'organizzazione non è in un piano Enterprise	400	`questo endpoint non è supportato per questo tipo di organizzazione`
Fatturazione del credito di utilizzo non abilitata	400	`la fatturazione del sovraccarico non è abilitata per questa organizzazione`

6. Ottenere una richiesta di aumento

GET /v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Restituisce una singola richiesta di aumento.

Richiede ambito: read:spend_limits.

Parametri del percorso

Campo	Tipo	Descrizione
`spend_limit_increase_request_id`	stringa	Con prefisso `slir_`.

Risposta

Un oggetto SpendLimitIncreaseRequest.

Richiesta di esempio

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

Convalide

Condizione	Stato	Messaggio
Richiesta non trovata in questa organizzazione	404
Il richiedente non è più un membro di questa organizzazione	404
L'organizzazione non è in un piano Enterprise	400	`questo endpoint non è supportato per questo tipo di organizzazione`
Fatturazione con crediti di utilizzo non abilitata	400	`la fatturazione per eccedenza non è abilitata per questa organizzazione`

7. Approva una richiesta di aumento

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

Approva una richiesta in sospeso. Scrive un limite di spesa per utente in amount per il richiedente e trasferisce la richiesta a approved. Se la richiesta non contiene un importo richiesto, l'amministratore fornisce il nuovo limite al momento dell'approvazione.

Richiede ambito: write:spend_limits.

Parametri del percorso

Campo	Tipo	Descrizione
`spend_limit_increase_request_id`	stringa	Con prefisso `slir_`.

Corpo della richiesta

Campo	Tipo	Obbligatorio	Predefinito	Descrizione
`amount`	stringa	Sì	—	Nuovo limite per utente per il `period`, in unità minori, come stringa decimale intera non negativa.
`period`	stringa	No	`"monthly"`	Vedi la sezione "Period".
`suppress_notification`	booleano	No	`false`	Se `true`, Anthropic non invia un'email al membro per notificare che la sua richiesta è stata approvata.

Risposta

SpendLimitIncreaseRequest nello stato approved, con un campo aggiuntivo spend_limit contenente lo SpendLimit che è stato scritto.

Richiesta di esempio

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

Risposta di esempio

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

Convalide

Condizione	Stato	Messaggio
Richiesta non trovata in questa organizzazione	404
Il richiedente non è più un membro di questa organizzazione	404
Richiesta già `approvata` o `negata`	400	`la richiesta di aumento del limite di spesa è già risolta`
`importo` negativo, frazionario o non è una stringa decimale valida	400
`periodo` non è `"mensile"`	400	`periodo: non ancora supportato`
L'organizzazione non è in un piano Enterprise	400	`questo endpoint non è supportato per questo tipo di organizzazione`
Fatturazione crediti di utilizzo non abilitata	400	`la fatturazione per eccedenza non è abilitata per questa organizzazione`

8. Nega una richiesta di aumento

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

Nega una richiesta in sospeso. Idempotente su negata: negare una richiesta già negata restituisce 200 con la risorsa esistente. Negare una richiesta già approvata viene rifiutata in modo che l'automazione possa distinguere un nuovo tentativo da una decisione conflittuale.

Richiede ambito: write:spend_limits.

Parametri del percorso

Campo	Tipo	Descrizione
`spend_limit_increase_request_id`	stringa	Con prefisso `slir_`.

Corpo della richiesta

Campo	Tipo	Obbligatorio	Predefinito	Descrizione
`suppress_notification`	booleano	No	`falso`	Se `vero`, Anthropic non invia un'email al membro per informarlo che la sua richiesta è stata negata.

Risposta

Una SpendLimitIncreaseRequest con stato negato.

Richiesta di esempio

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

Convalide

Condizione	Stato	Messaggio
Richiesta non trovata in questa organizzazione	404
Il richiedente non è più un membro di questa organizzazione	404
Richiesta già `approvata`	400	`la richiesta di aumento del limite di spesa è già approvata`
Richiesta già `negata`	— (200, idempotent)
L'organizzazione non è su un piano Enterprise	400	`questo endpoint non è supportato per questo tipo di organizzazione`
Crediti di utilizzo non abilitati	400	`la fatturazione per eccedenza non è abilitata per questa organizzazione`