Claude Platform Docs

Beta

Models
AnthropicBeta = string or "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 47 more
One of the following:
BetaAPIError object{ type: "api_error", message }
type: "api_error"
defaultapi_error
message: string
defaultInternal server error
BetaAuthenticationError object{ type: "authentication_error", message }
type: "authentication_error"
defaultauthentication_error
message: string
defaultAuthentication error
BetaBillingError object{ type: "billing_error", message }
type: "billing_error"
defaultbilling_error
message: string
defaultBilling error
BetaCurrency = "USD"
BetaError = BetaInvalidRequestError or BetaAuthenticationError or BetaBillingError or 6 more
One of the following:
BetaErrorResponse object{ type: "error", error, request_id }
type: "error"
defaulterror
error: BetaError
One of the following:
request_id: string or null
BetaGatewayTimeoutError object{ type: "timeout_error", message }
type: "timeout_error"
defaulttimeout_error
message: string
defaultRequest timeout
BetaInvalidRequestError object{ type: "invalid_request_error", message }
type: "invalid_request_error"
defaultinvalid_request_error
message: string
defaultInvalid request
BetaMonetaryAmount object{ amount, currency }

A monetary amount in a specific currency.

amount: string

Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.

currency: BetaCurrency

Uppercase ISO-4217 currency code. USD is the only currency currently supported; the accepted set is closed and grows only when a new currency is priced.

BetaNotFoundError object{ type: "not_found_error", message }
type: "not_found_error"
defaultnot_found_error
message: string
defaultNot found
BetaOverloadedError object{ type: "overloaded_error", message }
type: "overloaded_error"
defaultoverloaded_error
message: string
defaultOverloaded
BetaPermissionError object{ type: "permission_error", message }
type: "permission_error"
defaultpermission_error
message: string
defaultPermission denied
BetaRateLimitError object{ type: "rate_limit_error", message }
type: "rate_limit_error"
defaultrate_limit_error
message: string
defaultRate limited

BetaModelli

Elenca i modelli
GET/v1/models

Elenca i modelli disponibili.

Ottieni un modello
GET/v1/models/{model_id}

Ottieni un modello specifico.

BetaMessaggi

Crea un messaggio
POST/v1/messages

Invia un elenco strutturato di messaggi di input con contenuto testuale e/o immagini, e il modello genererà il messaggio successivo nella conversazione.

Conta i token in un messaggio
POST/v1/messages/count_tokens

Conta il numero di token in un messaggio.

BetaMessaggiBatch

Crea un batch di messaggi
POST/v1/messages/batches

Invia un batch di richieste di creazione di messaggi.

Recupera un batch di messaggi
GET/v1/messages/batches/{message_batch_id}

Questo endpoint è idempotente e può essere utilizzato per eseguire il polling del completamento di un batch di messaggi. Per accedere ai risultati di un batch di messaggi, effettua una richiesta all'URL indicato nel campo results_url della risposta.

Elenca i batch di messaggi
GET/v1/messages/batches

Elenca tutti i batch di messaggi all'interno di un Workspace. I batch creati più di recente vengono restituiti per primi.

Annulla un batch di messaggi
POST/v1/messages/batches/{message_batch_id}/cancel

I batch possono essere annullati in qualsiasi momento prima del termine dell'elaborazione. Una volta avviato l'annullamento, il batch entra nello stato canceling, durante il quale il sistema può completare eventuali richieste in corso non interrompibili prima di finalizzare l'annullamento.

Elimina un batch di messaggi
DELETE/v1/messages/batches/{message_batch_id}
Recupera i risultati di un batch di messaggi
GET/v1/messages/batches/{message_batch_id}/results

Trasmette in streaming i risultati di un batch di messaggi come file .jsonl.

BetaAgenti

Crea agente
POST/v1/agents
Elenca gli agenti
GET/v1/agents
Ottieni agente
GET/v1/agents/{agent_id}
Aggiorna agente
POST/v1/agents/{agent_id}
Archivia agente
POST/v1/agents/{agent_id}/archive

BetaAgentiVersioni

Elenca le versioni dell'agente
GET/v1/agents/{agent_id}/versions

BetaAmbienti

Crea ambiente
POST/v1/environments

Crea un nuovo ambiente con la configurazione specificata.

Elenca gli ambienti
GET/v1/environments

Elenca gli ambienti con supporto per la paginazione.

Ottieni ambiente
GET/v1/environments/{environment_id}

Recupera un ambiente specifico tramite ID.

Aggiorna ambiente
POST/v1/environments/{environment_id}

Aggiorna la configurazione di un ambiente esistente.

Elimina ambiente
DELETE/v1/environments/{environment_id}

Elimina un ambiente tramite ID. Restituisce una conferma dell'eliminazione.

Archivia ambiente
POST/v1/environments/{environment_id}/archive

Archivia un ambiente tramite ID. Gli ambienti archiviati non possono essere utilizzati per creare nuove sessioni.

BetaAmbientiLavoro

Ottieni elemento di lavoro
GET/v1/environments/{environment_id}/work/{work_id}

Nota: questi endpoint vengono chiamati automaticamente dal worker di ambiente predefinito fornito negli SDK e nella CLI, per orchestrare le sessioni con ambienti sandbox self-hosted. Sono inclusi qui come riferimento; non è necessario invocarli direttamente.

Esegui polling del lavoro
GET/v1/environments/{environment_id}/work/poll

Nota: questi endpoint vengono chiamati automaticamente dal worker di ambiente predefinito fornito negli SDK e nella CLI, per orchestrare le sessioni con ambienti sandbox self-hosted. Sono inclusi qui come riferimento; non è necessario invocarli direttamente.

Conferma ricezione del lavoro
POST/v1/environments/{environment_id}/work/{work_id}/ack

Nota: questi endpoint vengono chiamati automaticamente dal worker di ambiente predefinito fornito negli SDK e nella CLI, per orchestrare le sessioni con ambienti sandbox self-hosted. Sono inclusi qui come riferimento; non è necessario invocarli direttamente.

Registra heartbeat
POST/v1/environments/{environment_id}/work/{work_id}/heartbeat

Nota: questi endpoint vengono chiamati automaticamente dal worker di ambiente predefinito fornito negli SDK e nella CLI, per orchestrare le sessioni con ambienti sandbox self-hosted. Sono inclusi qui come riferimento; non è necessario invocarli direttamente.

Arresta lavoro
POST/v1/environments/{environment_id}/work/{work_id}/stop

Nota: questi endpoint vengono chiamati automaticamente dal worker di ambiente predefinito fornito negli SDK e nella CLI, per orchestrare le sessioni con ambienti sandbox self-hosted. Sono inclusi qui come riferimento; non è necessario invocarli direttamente.

Elenca gli elementi di lavoro
GET/v1/environments/{environment_id}/work

Nota: questi endpoint vengono chiamati automaticamente dal worker di ambiente predefinito fornito negli SDK e nella CLI, per orchestrare le sessioni con ambienti sandbox self-hosted. Sono inclusi qui come riferimento; non è necessario invocarli direttamente.

Aggiorna elemento di lavoro
POST/v1/environments/{environment_id}/work/{work_id}

Nota: questi endpoint vengono chiamati automaticamente dal worker di ambiente predefinito fornito negli SDK e nella CLI, per orchestrare le sessioni con ambienti sandbox self-hosted. Sono inclusi qui come riferimento; non è necessario invocarli direttamente.

Ottieni statistiche della coda
GET/v1/environments/{environment_id}/work/stats

Ottieni statistiche sulla coda di lavoro per un ambiente.

BetaSessioni

Crea sessione
POST/v1/sessions
Elenca le sessioni
GET/v1/sessions
Ottieni sessione
GET/v1/sessions/{session_id}
Aggiorna sessione
POST/v1/sessions/{session_id}
Elimina sessione
DELETE/v1/sessions/{session_id}
Archivia sessione
POST/v1/sessions/{session_id}/archive

BetaSessioniEventi

Elenca gli eventi
GET/v1/sessions/{session_id}/events
Invia eventi
POST/v1/sessions/{session_id}/events
Trasmetti eventi in streaming
GET/v1/sessions/{session_id}/events/stream

BetaSessioniRisorse

Aggiungi risorsa di sessione
POST/v1/sessions/{session_id}/resources
Elenca le risorse di sessione
GET/v1/sessions/{session_id}/resources
Ottieni risorsa di sessione
GET/v1/sessions/{session_id}/resources/{resource_id}
Aggiorna risorsa di sessione
POST/v1/sessions/{session_id}/resources/{resource_id}
Elimina risorsa di sessione
DELETE/v1/sessions/{session_id}/resources/{resource_id}

BetaSessioniThread

Elenca i thread di sessione
GET/v1/sessions/{session_id}/threads
Ottieni thread di sessione
GET/v1/sessions/{session_id}/threads/{thread_id}
Archivia thread di sessione
POST/v1/sessions/{session_id}/threads/{thread_id}/archive

BetaSessioniThreadEventi

Elenca gli eventi del thread di sessione
GET/v1/sessions/{session_id}/threads/{thread_id}/events
Trasmetti in streaming gli eventi del thread di sessione
GET/v1/sessions/{session_id}/threads/{thread_id}/stream

BetaDeployment

Crea deployment
POST/v1/deployments
Elenca i deployment
GET/v1/deployments
Ottieni deployment
GET/v1/deployments/{deployment_id}
Aggiorna deployment
POST/v1/deployments/{deployment_id}
Archivia deployment
POST/v1/deployments/{deployment_id}/archive
Esegui deployment ora
POST/v1/deployments/{deployment_id}/run
Sospendi deployment
POST/v1/deployments/{deployment_id}/pause
Riprendi deployment
POST/v1/deployments/{deployment_id}/unpause

BetaEsecuzioni del deployment

Elenca esecuzioni del deployment
GET/v1/deployment_runs
Ottieni esecuzione del deployment
GET/v1/deployment_runs/{deployment_run_id}

BetaVault

Crea vault
POST/v1/vaults
Elenca vault
GET/v1/vaults
Ottieni vault
GET/v1/vaults/{vault_id}
Aggiorna vault
POST/v1/vaults/{vault_id}
Elimina vault
DELETE/v1/vaults/{vault_id}
Archivia vault
POST/v1/vaults/{vault_id}/archive

BetaVaultCredenziali

Crea credenziale
POST/v1/vaults/{vault_id}/credentials
Elenca credenziali
GET/v1/vaults/{vault_id}/credentials
Ottieni credenziale
GET/v1/vaults/{vault_id}/credentials/{credential_id}
Aggiorna credenziale
POST/v1/vaults/{vault_id}/credentials/{credential_id}
Elimina credenziale
DELETE/v1/vaults/{vault_id}/credentials/{credential_id}
Archivia credenziale
POST/v1/vaults/{vault_id}/credentials/{credential_id}/archive
Convalida credenziale
POST/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate

BetaArchivi di memoria

Crea un archivio di memoria
POST/v1/memory_stores
Elenca archivi di memoria
GET/v1/memory_stores
Recupera un archivio di memoria
GET/v1/memory_stores/{memory_store_id}
Aggiorna un archivio di memoria
POST/v1/memory_stores/{memory_store_id}
Elimina un archivio di memoria
DELETE/v1/memory_stores/{memory_store_id}
Archivia un archivio di memoria
POST/v1/memory_stores/{memory_store_id}/archive

BetaArchivi di memoriaMemorie

Crea una memoria
POST/v1/memory_stores/{memory_store_id}/memories
Elenca memorie
GET/v1/memory_stores/{memory_store_id}/memories
Recupera una memoria
GET/v1/memory_stores/{memory_store_id}/memories/{memory_id}
Aggiorna una memoria
POST/v1/memory_stores/{memory_store_id}/memories/{memory_id}
Elimina una memoria
DELETE/v1/memory_stores/{memory_store_id}/memories/{memory_id}

BetaArchivi di memoriaVersioni della memoria

Elenca versioni della memoria
GET/v1/memory_stores/{memory_store_id}/memory_versions
Recupera una versione della memoria
GET/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}
Oscura una versione della memoria
POST/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact

BetaFile

Carica file
POST/v1/files
Elenca i file
GET/v1/files
Scarica file
GET/v1/files/{file_id}/content
Ottieni metadati del file
GET/v1/files/{file_id}
Elimina file
DELETE/v1/files/{file_id}

BetaSkill

Crea skill
POST/v1/skills
Elenca le skill
GET/v1/skills
Ottieni skill
GET/v1/skills/{skill_id}
Elimina skill
DELETE/v1/skills/{skill_id}

BetaSkillVersioni

Crea versione della skill
POST/v1/skills/{skill_id}/versions
Elenca le versioni della skill
GET/v1/skills/{skill_id}/versions
Scarica contenuto versione skill
GET/v1/skills/{skill_id}/versions/{version}/content

Scarica il contenuto di una versione della skill come archivio zip.

Ottieni versione della skill
GET/v1/skills/{skill_id}/versions/{version}
Elimina versione della skill
DELETE/v1/skills/{skill_id}/versions/{version}

BetaProfili utente

Crea profilo utente
POST/v1/user_profiles
Elenca profili utente
GET/v1/user_profiles
Ottieni profilo utente
GET/v1/user_profiles/{user_profile_id}
Aggiorna profilo utente
POST/v1/user_profiles/{user_profile_id}
Crea URL di registrazione
POST/v1/user_profiles/{user_profile_id}/enrollment_url

BetaDream

Crea un Dream
POST/v1/dreams

Avvia un job asincrono che usa le sessioni passate per produrre una versione riorganizzata di un archivio di memoria e restituisce il dream da interrogare per ottenere il risultato.

Elenca Dream
GET/v1/dreams

Elenca i dream nel workspace, dal più recente.

Ottieni un Dream
GET/v1/dreams/{dream_id}

Ottieni un dream tramite ID per verificarne lo stato, l'archivio di memoria di output e l'utilizzo dei token.

Annulla un Dream
POST/v1/dreams/{dream_id}/cancel

Interrompi un dream pending o running.

Archivia un Dream
POST/v1/dreams/{dream_id}/archive

Nascondi un dream completed, failed o canceled dall'elenco predefinito dei dream.

BetaTunnel

Crea tunnel
POST/v1/tunnels

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

Ottieni tunnel
GET/v1/tunnels/{tunnel_id}

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

Elenca tunnel
GET/v1/tunnels

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

Archivia tunnel
POST/v1/tunnels/{tunnel_id}/archive

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

Rivela token del tunnel
POST/v1/tunnels/{tunnel_id}/reveal_token

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

Ruota token del tunnel
POST/v1/tunnels/{tunnel_id}/rotate_token

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

BetaTunnelCertificati

Crea certificato del tunnel
POST/v1/tunnels/{tunnel_id}/certificates

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

Ottieni certificato del tunnel
GET/v1/tunnels/{tunnel_id}/certificates/{certificate_id}

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

Elenca certificati del tunnel
GET/v1/tunnels/{tunnel_id}/certificates

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

Archivia certificato del tunnel
POST/v1/tunnels/{tunnel_id}/certificates/{certificate_id}/archive

L'API Tunnels è in research preview (anteprima di ricerca). Richiede l'header anthropic-beta: mcp-tunnels-2026-06-22 e può cambiare senza un periodo di deprecazione. Sostituisce gli endpoint dell'Admin API in /v1/organizations/tunnels, che rimangono disponibili durante una finestra di migrazione.

BetaOrganizzazione

Ottieni l'organizzazione corrente
GET/v1/organizations/me

Recupera le informazioni sull'organizzazione associata alla chiave API autenticata.

BetaOrganizzazioneChiavi API

Elenca chiavi API
GET/v1/organizations/api_keys
Recupera chiave API (Admin API)
GET/v1/organizations/api_keys/{api_key_id}

Recupera le informazioni su una singola chiave API nella tua organizzazione, cercata tramite il suo ID. Questo endpoint dell'Admin API richiede una chiave Admin API, è destinato alla gestione programmatica delle chiavi e non restituisce mai il valore segreto della chiave. Per visualizzare o creare le tue chiavi API, vai a Chiavi API nella Claude Console.

Aggiorna chiave API
POST/v1/organizations/api_keys/{api_key_id}

BetaOrganizzazioneChiavi esterne

Crea chiave esterna
POST/v1/organizations/external_keys

Crea una configurazione di chiave esterna di proprietà dell'organizzazione del chiamante.

Elenca chiavi esterne
GET/v1/organizations/external_keys

Elenca le configurazioni di chiavi esterne nell'organizzazione del chiamante.

Ottieni chiave esterna
GET/v1/organizations/external_keys/{external_key_id}

Recupera una singola configurazione di chiave esterna nell'organizzazione del chiamante tramite ID.

Aggiorna chiave esterna
POST/v1/organizations/external_keys/{external_key_id}

Aggiorna parzialmente una configurazione di chiave esterna. I campi omessi restano invariati.

Elimina chiave esterna
DELETE/v1/organizations/external_keys/{external_key_id}

Elimina una configurazione di chiave esterna.

Convalida chiave esterna
POST/v1/organizations/external_keys/{external_key_id}/validate

Convalida una configurazione di chiave esterna rispetto al KMS del cliente.

BetaOrganizzazioneFederazioneEmittenti

Crea issuer di federazione
POST/v1/organizations/federation_issuers

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Elenca issuer di federazione
GET/v1/organizations/federation_issuers

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Ottieni issuer di federazione
GET/v1/organizations/federation_issuers/{federation_issuer_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Aggiorna issuer di federazione
POST/v1/organizations/federation_issuers/{federation_issuer_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Archivia issuer di federazione
POST/v1/organizations/federation_issuers/{federation_issuer_id}/archive

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

BetaOrganizzazioneFederazioneRegole

Crea regola di federazione
POST/v1/organizations/federation_rules

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Elenca regole di federazione
GET/v1/organizations/federation_rules

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Ottieni regola di federazione
GET/v1/organizations/federation_rules/{federation_rule_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Aggiorna regola di federazione
POST/v1/organizations/federation_rules/{federation_rule_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Archivia regola di federazione
POST/v1/organizations/federation_rules/{federation_rule_id}/archive

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

BetaOrganizzazioneFederazioneRegoleWorkspace

Aggiungi workspace alla regola di federazione
POST/v1/organizations/federation_rules/{federation_rule_id}/workspaces

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Elenca workspace della regola di federazione
GET/v1/organizations/federation_rules/{federation_rule_id}/workspaces

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Rimuovi workspace dalla regola di federazione
DELETE/v1/organizations/federation_rules/{federation_rule_id}/workspaces/{workspace_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

BetaOrganizzazioneInviti

Crea invito
POST/v1/organizations/invites

Invita un utente a unirsi all'organizzazione tramite email.

Elenca inviti
GET/v1/organizations/invites

Elenca gli inviti dell'organizzazione.

Ottieni invito
GET/v1/organizations/invites/{invite_id}

Recupera un invito tramite ID.

Elimina invito
DELETE/v1/organizations/invites/{invite_id}

Elimina un invito in sospeso.

BetaOrganizzazioneService account

Crea service account
POST/v1/organizations/service_accounts

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Elenca service account
GET/v1/organizations/service_accounts

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Ottieni service account
GET/v1/organizations/service_accounts/{service_account_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Aggiorna service account
POST/v1/organizations/service_accounts/{service_account_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Archivia service account
POST/v1/organizations/service_accounts/{service_account_id}/archive

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

BetaOrganizzazioneService accountWorkspace

Aggiungi workspace al service account
POST/v1/organizations/service_accounts/{service_account_id}/workspaces

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Elenca workspace per il service account
GET/v1/organizations/service_accounts/{service_account_id}/workspaces

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Rimuovi workspace dal service account
DELETE/v1/organizations/service_accounts/{service_account_id}/workspaces/{workspace_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

BetaOrganizzazioneUtenti

Elenca utenti
GET/v1/organizations/users

Elenca i membri dell'organizzazione.

Ottieni utente
GET/v1/organizations/users/{user_id}

Recupera un membro dell'organizzazione tramite ID utente.

Aggiorna utente
POST/v1/organizations/users/{user_id}

Aggiorna il ruolo nell'organizzazione di un membro.

Rimuovi utente
DELETE/v1/organizations/users/{user_id}

Rimuovi un membro dall'organizzazione.

BetaOrganizzazioneWorkspace

Elenca workspace
GET/v1/organizations/workspaces
Crea workspace
POST/v1/organizations/workspaces
Ottieni workspace
GET/v1/organizations/workspaces/{workspace_id}
Aggiorna workspace
POST/v1/organizations/workspaces/{workspace_id}
Archivia workspace
POST/v1/organizations/workspaces/{workspace_id}/archive

BetaOrganizzazioneWorkspaceLimiti di velocità

Elenca limiti di velocità del workspace
GET/v1/organizations/workspaces/{workspace_id}/rate_limits

Elenca i "rate limit" (limiti di velocità) di un workspace.

BetaOrganizzazioneWorkspaceMembri

Elenca membri del workspace
GET/v1/organizations/workspaces/{workspace_id}/members
Crea membro del workspace
POST/v1/organizations/workspaces/{workspace_id}/members
Ottieni membro del workspace
GET/v1/organizations/workspaces/{workspace_id}/members/{user_id}
Aggiorna membro del workspace
POST/v1/organizations/workspaces/{workspace_id}/members/{user_id}
Elimina membro del workspace
DELETE/v1/organizations/workspaces/{workspace_id}/members/{user_id}

BetaOrganizzazioneWorkspaceService account

Elenca membri service account del workspace
GET/v1/organizations/workspaces/{workspace_id}/service_accounts

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi Admin API non sono accettate. Consulta Gestisci WIF con l'Admin API.

Crea membro service account del workspace
POST/v1/organizations/workspaces/{workspace_id}/service_accounts

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi API Admin non sono accettate. Consulta Gestire WIF con l'Admin API.

Ottieni membro service account del workspace
GET/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi API Admin non sono accettate. Consulta Gestire WIF con l'Admin API.

Aggiorna membro service account del workspace
POST/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi API Admin non sono accettate. Consulta Gestire WIF con l'Admin API.

Elimina membro service account del workspace
DELETE/v1/organizations/workspaces/{workspace_id}/service_accounts/{service_account_id}

Richiede un token di accesso OAuth con lo scope org:admin, ottenuto da ant auth login --scope org:admin o da una regola di workload identity federation; le chiavi API Admin non sono accettate. Consulta Gestire WIF con l'Admin API.

BetaOrganizzazioneLimiti di velocità

Elenca limiti di velocità dell'organizzazione
GET/v1/organizations/rate_limits

List Messages API rate limits for your organization.

BetaOrganizzazioneImpostazioni di conformità

Ottieni impostazioni di conformità
GET/v1/organizations/compliance_settings

Recupera le impostazioni di conformità (Compliance Settings) della tua organizzazione.

Aggiorna impostazioni di conformità
POST/v1/organizations/compliance_settings

Aggiorna le impostazioni di conformità (Compliance Settings) della tua organizzazione.

BetaOrganizzazioneReport di utilizzo

Ottieni report di utilizzo Messages
GET/v1/organizations/usage_report/messages
Ottieni report di utilizzo Claude Code
GET/v1/organizations/usage_report/claude_code

Recupera le metriche di utilizzo aggregate giornaliere per gli utenti di Claude Code. Consente alle organizzazioni di analizzare la produttività degli sviluppatori e creare dashboard personalizzate.

BetaOrganizzazioneReport dei costi

Ottieni report dei costi
GET/v1/organizations/cost_report

BetaOrganizzazioneTunnel MCP

Elenca tunnel
Deprecated
GET/v1/organizations/tunnels

Deprecato. Questo endpoint dell'Admin API è sostituito da /v1/tunnels sulla Claude API e verrà rimosso dopo una finestra di migrazione. Le nuove integrazioni dovrebbero usare /v1/tunnels con l'header anthropic-beta: mcp-tunnels-2026-06-22 e un token WIF con lo scope workspace:manage_tunnels. Le integrazioni esistenti continuano a funzionare con l'header mcp-tunnels-2026-05-19 e lo scope org:manage_tunnels durante la finestra di migrazione.

Ottieni tunnel
Deprecated
GET/v1/organizations/tunnels/{tunnel_id}

Deprecato. Questo endpoint dell'Admin API è sostituito da /v1/tunnels sulla Claude API e verrà rimosso dopo una finestra di migrazione. Le nuove integrazioni devono usare /v1/tunnels con l'header anthropic-beta: mcp-tunnels-2026-06-22 e un token WIF con lo scope workspace:manage_tunnels. Le integrazioni esistenti continuano a funzionare con l'header mcp-tunnels-2026-05-19 e lo scope org:manage_tunnels durante la finestra di migrazione.

Archivia tunnel
Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/archive

Deprecato. Questo endpoint dell'Admin API è sostituito da /v1/tunnels sulla Claude API e verrà rimosso dopo una finestra di migrazione. Le nuove integrazioni devono usare /v1/tunnels con l'header anthropic-beta: mcp-tunnels-2026-06-22 e un token WIF con lo scope workspace:manage_tunnels. Le integrazioni esistenti continuano a funzionare con l'header mcp-tunnels-2026-05-19 e lo scope org:manage_tunnels durante la finestra di migrazione.

Rivela token del tunnel
Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/reveal_token

Deprecato. Questo endpoint dell'Admin API è sostituito da /v1/tunnels sulla Claude API e verrà rimosso dopo una finestra di migrazione. Le nuove integrazioni dovrebbero usare /v1/tunnels con l'header anthropic-beta: mcp-tunnels-2026-06-22 e un token WIF con lo scope workspace:manage_tunnels. Le integrazioni esistenti continuano a funzionare con l'header mcp-tunnels-2026-05-19 e lo scope org:manage_tunnels durante la finestra di migrazione.

Ruota token del tunnel
Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/rotate_token

Deprecato. Questo endpoint dell'Admin API è sostituito da /v1/tunnels sulla Claude API e verrà rimosso dopo una finestra di migrazione. Le nuove integrazioni dovrebbero usare /v1/tunnels con l'header anthropic-beta: mcp-tunnels-2026-06-22 e un token WIF con lo scope workspace:manage_tunnels. Le integrazioni esistenti continuano a funzionare con l'header mcp-tunnels-2026-05-19 e lo scope org:manage_tunnels durante la finestra di migrazione.

BetaOrganizzazioneTunnel MCPCertificati del tunnel

Crea certificato del tunnel
Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/certificates

Deprecato. Questo endpoint dell'Admin API è sostituito da /v1/tunnels sulla Claude API e verrà rimosso dopo una finestra di migrazione. Le nuove integrazioni devono usare /v1/tunnels con l'header anthropic-beta: mcp-tunnels-2026-06-22 e un token WIF con lo scope workspace:manage_tunnels. Le integrazioni esistenti continuano a funzionare con l'header mcp-tunnels-2026-05-19 e lo scope org:manage_tunnels durante la finestra di migrazione.

Elenca certificati del tunnel
Deprecated
GET/v1/organizations/tunnels/{tunnel_id}/certificates

Deprecato. Questo endpoint dell'Admin API è sostituito da /v1/tunnels sulla Claude API e verrà rimosso dopo una finestra di migrazione. Le nuove integrazioni dovrebbero usare /v1/tunnels con l'header anthropic-beta: mcp-tunnels-2026-06-22 e un token WIF con lo scope workspace:manage_tunnels. Le integrazioni esistenti continuano a funzionare con l'header mcp-tunnels-2026-05-19 e lo scope org:manage_tunnels durante la finestra di migrazione.

Ottieni certificato del tunnel
Deprecated
GET/v1/organizations/tunnels/{tunnel_id}/certificates/{certificate_id}

Deprecato. Questo endpoint dell'Admin API è sostituito da /v1/tunnels sulla Claude API e verrà rimosso dopo una finestra di migrazione. Le nuove integrazioni devono usare /v1/tunnels con l'header anthropic-beta: mcp-tunnels-2026-06-22 e un token WIF con lo scope workspace:manage_tunnels. Le integrazioni esistenti continuano a funzionare con l'header mcp-tunnels-2026-05-19 e lo scope org:manage_tunnels durante la finestra di migrazione.

Archivia certificato del tunnel
Deprecated
POST/v1/organizations/tunnels/{tunnel_id}/certificates/{certificate_id}/archive

Deprecato. Questo endpoint dell'Admin API è sostituito da /v1/tunnels sulla Claude API e verrà rimosso dopo una finestra di migrazione. Le nuove integrazioni dovrebbero usare /v1/tunnels con l'header anthropic-beta: mcp-tunnels-2026-06-22 e un token WIF con lo scope workspace:manage_tunnels. Le integrazioni esistenti continuano a funzionare con l'header mcp-tunnels-2026-05-19 e lo scope org:manage_tunnels durante la finestra di migrazione.

BetaOrganizzazioneAnalisiSummaries

Ottieni riepiloghi delle attività
GET/v1/organizations/analytics/summaries

Get organization-wide activity summaries for a date range.

BetaOrganizzazioneAnalisiUtenti

Elenca attività utente
GET/v1/organizations/analytics/users

Ottieni l'attività per utente per un determinato giorno, con paginazione basata su cursore.

BetaOrganizzazioneAnalisiAppChatProgetti

Ottieni utilizzo dei progetti chat
GET/v1/organizations/analytics/apps/chat/projects

Ottieni l'attività per progetto per un determinato giorno, con paginazione basata su cursore.

BetaOrganizzazioneAnalisiConnettori

Ottieni utilizzo dei connettori
GET/v1/organizations/analytics/connectors

Ottieni l'utilizzo per connettore per un determinato giorno, con paginazione basata su cursore.

BetaOrganizzazioneAnalisiPlugin

Ottieni utilizzo dei plugin
GET/v1/organizations/analytics/plugins

Ottieni l'utilizzo di installazione + invocazione per plugin per un determinato giorno, con paginazione.

BetaOrganizzazioneAnalisiSkill

Ottieni utilizzo delle skill
GET/v1/organizations/analytics/skills

Ottieni l'utilizzo per skill per un determinato giorno, con paginazione basata su cursore.

BetaOrganizzazioneAnalisiArtifacts

Ottieni attività degli artifact
GET/v1/organizations/analytics/artifacts

Ottieni l'attività di creazione di artifact per un determinato giorno, suddivisa per tipo MIME.

BetaOrganizzazioneAnalisiReport di utilizzo

Ottieni utilizzo dei token nel tempo
GET/v1/organizations/analytics/usage_report

Ottieni l'utilizzo dei token nel tempo in un intervallo di date.

BetaOrganizzazioneAnalisiUser Usage Report

Ottieni utilizzo dei token per utente
GET/v1/organizations/analytics/user_usage_report

Ottieni l'utilizzo dei token per utente in un intervallo di date.

BetaOrganizzazioneAnalisiReport dei costi

Ottieni costo nel tempo
GET/v1/organizations/analytics/cost_report

Ottieni il costo in USD nel tempo in un intervallo di date.

BetaOrganizzazioneAnalisiUser Cost Report

Ottieni costo per utente
GET/v1/organizations/analytics/user_cost_report

Ottieni il costo per utente in USD in un intervallo di date.

BetaOrganizzazioneLimiti di spesa

Imposta limite di spesa
POST/v1/organizations/spend_limits

Imposta un limite di spesa.

Ottieni limite di spesa
GET/v1/organizations/spend_limits/{spend_limit_id}

Recupera un limite di spesa tramite ID.

Elimina limite di spesa
DELETE/v1/organizations/spend_limits/{spend_limit_id}

Elimina un limite di spesa.

List Spend Limits
GET/v1/organizations/spend_limits

List the organization's spend limits.

BetaOrganizzazioneLimiti di spesaEffective

Elenca limiti di spesa effettivi
GET/v1/organizations/spend_limits/effective

Elenca il limite di spesa effettivo di ogni membro e la spesa dall'inizio del periodo.

BetaOrganizzazioneLimiti di spesaRichieste di aumento

Elenca richieste di aumento del limite di spesa
GET/v1/organizations/spend_limit_increase_requests

Elenca le richieste di aumento del limite di spesa, dalla più recente.

Ottieni richiesta di aumento del limite di spesa
GET/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}

Recupera una richiesta di aumento del limite di spesa.

Approva richiesta di aumento del limite di spesa
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/approve

Approva una richiesta di aumento del limite di spesa in sospeso.

Rifiuta richiesta di aumento del limite di spesa
POST/v1/organizations/spend_limit_increase_requests/{spend_limit_increase_request_id}/deny

Rifiuta una richiesta di aumento del limite di spesa in sospeso.

BetaOrganizzazioneGruppi RBAC

Crea gruppo RBAC
POST/v1/organizations/rbac_groups

Crea un gruppo RBAC nel tenant Claude Enterprise. I gruppi creati tramite l'API hanno tipo di origine "direct".

Elenca gruppi RBAC
GET/v1/organizations/rbac_groups

Elenca i gruppi RBAC nel tenant Claude Enterprise.

Ottieni gruppo RBAC
GET/v1/organizations/rbac_groups/{rbac_group_id}

Recupera un gruppo RBAC tramite ID.

Aggiorna gruppo RBAC
POST/v1/organizations/rbac_groups/{rbac_group_id}

Aggiorna il nome di un gruppo RBAC. I gruppi forniti da un provider di identità (tipo di origine "scim") non possono essere modificati tramite l'API mentre un'organizzazione nel tenant usa il provisioning SCIM.

Elimina gruppo RBAC
DELETE/v1/organizations/rbac_groups/{rbac_group_id}

Elimina un gruppo RBAC. I gruppi forniti da un provider di identità (tipo di origine "scim") non possono essere eliminati tramite l'API mentre un'organizzazione nel tenant usa il provisioning SCIM.

BetaOrganizzazioneGruppi RBACMembri

Elenca membri del gruppo RBAC
GET/v1/organizations/rbac_groups/{rbac_group_id}/members

Elenca i membri di un gruppo RBAC.

Aggiungi membro al gruppo RBAC
POST/v1/organizations/rbac_groups/{rbac_group_id}/members

Aggiunge un utente a un gruppo RBAC. L'appartenenza ai gruppi forniti da un provider di identità (tipo di origine "scim") non può essere modificata tramite l'API mentre un'organizzazione nel tenant usa il provisioning SCIM.

Rimuovi membro dal gruppo RBAC
DELETE/v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}

Rimuove un utente da un gruppo RBAC. L'appartenenza ai gruppi forniti da un provider di identità (tipo di origine "scim") non può essere modificata tramite l'API mentre un'organizzazione nel tenant usa il provisioning SCIM.

BetaOrganizzazioneRuoli RBAC

Elenca ruoli RBAC
GET/v1/organizations/rbac_roles

Elenca i ruoli RBAC nell'organizzazione.

Ottieni ruolo RBAC
GET/v1/organizations/rbac_roles/{rbac_role_id}

Recupera un ruolo RBAC tramite ID.

BetaOrganizzazioneRuoli RBACAutorizzazioni

Elenca autorizzazioni del ruolo RBAC
GET/v1/organizations/rbac_roles/{rbac_role_id}/permissions

Elenca le autorizzazioni concesse da un ruolo RBAC.

BetaOrganizzazionePlugin

Create Plugin
POST/v1/organizations/plugins

Create an organization-owned Plugin and its first version by uploading the version's files.

Get Plugin
GET/v1/organizations/plugins/{plugin_id}

Retrieve a Plugin by ID.

Update Plugin
POST/v1/organizations/plugins/{plugin_id}

Change which stored version of an organization-owned Plugin is served to members, for example to roll back to an earlier one. This pins the served version: later uploads are stored but no longer change what is served, and pinning cannot currently be undone, here or in claude.ai.

List Plugins
GET/v1/organizations/plugins

List the Plugins created under the organization, newest first: those in the organization's own plugin marketplaces and those in members' personal plugin marketplaces.

Delete Plugin
DELETE/v1/organizations/plugins/{plugin_id}

Permanently delete a Plugin and every version it holds, exactly as when an administrator deletes it in claude.ai. The Plugin may belong to the organization or to a member, including a member who has since left the organization.

BetaOrganizzazionePluginVersioni

Create Plugin Version
POST/v1/organizations/plugins/{plugin_id}/versions

Add a version to an organization-owned Plugin by uploading the new version's files; it becomes the version served to members unless the Plugin's served version has been pinned.

List Plugin Versions
GET/v1/organizations/plugins/{plugin_id}/versions

List a Plugin's versions, newest first.

Get Plugin Version
GET/v1/organizations/plugins/{plugin_id}/versions/{version}

Retrieve one version of a Plugin by its ID, or the Plugin's newest version.

Download Plugin Version Archive
GET/v1/organizations/plugins/{plugin_id}/versions/{version}/content

Download one version's .zip archive, exactly as stored. Each download of a Plugin from a member's personal plugin marketplace is recorded on the Compliance API activity feed.

BetaOrganizzazionePluginInstallation Settings

List Plugin Installation Settings
GET/v1/organizations/plugins/{plugin_id}/installation_settings

List an organization-owned Plugin's installation settings, which say which members it is for, most recently created first.

Set Plugin Installation Setting
POST/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Set or change an organization-owned Plugin's installation setting for the whole organization or for one RBAC Group.

Remove Plugin Installation Setting
DELETE/v1/organizations/plugins/{plugin_id}/installation_settings/{target}

Remove an organization-owned Plugin's own installation setting for the whole organization or for one RBAC Group.

BetaOrganizzazionePluginShares

List Plugin Shares
GET/v1/organizations/plugins/{plugin_id}/shares

List the shares the owner of a member-owned Plugin has given — to every member of the organization, to an RBAC Group, or to one member — most recently granted first.

BetaOrganizzazionePlugin Marketplaces

List Plugin Marketplaces
GET/v1/organizations/plugin_marketplaces

List the plugin marketplaces Plugins live in, newest first: the organization's own and its members' personal ones.

Get Plugin Marketplace
GET/v1/organizations/plugin_marketplaces/{marketplace_id}

Retrieve a plugin marketplace by ID.

Update Plugin Marketplace
POST/v1/organizations/plugin_marketplaces/{marketplace_id}

Set the default installation setting of one of the organization's own plugin marketplaces. Every Plugin in it without a setting of its own gets this default as its organization-wide setting, including Plugins added later.

Validate Plugin Marketplace Repository
POST/v1/organizations/plugin_marketplaces/validate_repository

Check whether a plugin marketplace held in a public GitHub repository would synchronize into claude.ai, without connecting or storing it.

Validate Plugin Marketplace Archive
POST/v1/organizations/plugin_marketplaces/validate_archive

Check whether a plugin marketplace, uploaded as a .zip of the marketplace directory, would synchronize into claude.ai, without connecting or storing it.