Panoramica dell'Admin API

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

L'Admin API ti consente di gestire programmaticamente le risorse della tua organizzazione, inclusi i membri dell'organizzazione, gli spazi di lavoro e le chiavi API. Questo fornisce il controllo programmatico su attività amministrative che altrimenti richiederebbero una configurazione manuale nella Claude Console.

L'Admin API richiede un accesso speciale

L'Admin API richiede una speciale chiave Admin API (che inizia con sk-ant-admin...) che differisce dalle chiavi API standard. Solo i membri dell'organizzazione con il ruolo di amministratore possono fornire chiavi Admin API tramite la Claude Console.

Come funziona l'Admin API

Quando utilizzi l'Admin API:

Effettui richieste utilizzando la tua chiave Admin API nell'intestazione x-api-key
L'API ti consente di gestire:
- I membri dell'organizzazione e i loro ruoli
- Gli inviti dei membri dell'organizzazione
- Gli spazi di lavoro e i loro membri
- Le chiavi API

Questo è utile per:

Automatizzare l'onboarding/offboarding degli utenti
Gestire programmaticamente l'accesso agli spazi di lavoro
Monitorare e gestire l'utilizzo delle chiavi API

Ruoli e autorizzazioni dell'organizzazione

Ci sono cinque ruoli a livello di organizzazione. Vedi ulteriori dettagli qui.

Ruolo	Autorizzazioni
user	Può utilizzare Workbench
claude_code_user	Può utilizzare Workbench e Claude Code
developer	Può utilizzare Workbench e gestire le chiavi API
billing	Può utilizzare Workbench e gestire i dettagli di fatturazione
admin	Può fare tutto quanto sopra, più gestire gli utenti

Concetti chiave

Membri dell'organizzazione

Puoi elencare i membri dell'organizzazione, aggiornare i ruoli dei membri e rimuovere i membri.

Shell

# Elenca i membri dell'organizzazione
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Aggiorna il ruolo del membro
curl "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"role": "developer"}'

# Rimuovi il membro
curl --request DELETE "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Inviti dell'organizzazione

Puoi invitare gli utenti alle organizzazioni e gestire quegli inviti.

Shell

# Crea un invito
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "email": "[email protected]",
    "role": "developer"
  }'

# Elenca gli inviti
curl "https://api.anthropic.com/v1/organizations/invites?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Elimina l'invito
curl --request DELETE "https://api.anthropic.com/v1/organizations/invites/{invite_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Spazi di lavoro

Per una guida completa agli spazi di lavoro, vedi Spazi di lavoro.

Crea e gestisci gli spazi di lavoro (console) per organizzare le tue risorse:

Shell

# Crea uno spazio di lavoro
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# Elenca gli spazi di lavoro
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Archivia lo spazio di lavoro
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Membri dello spazio di lavoro

Gestisci l'accesso degli utenti a spazi di lavoro specifici:

Shell

# Aggiungi un membro allo spazio di lavoro
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Elenca i membri dello spazio di lavoro
curl "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Aggiorna il ruolo del membro
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "workspace_role": "workspace_admin"
  }'

# Rimuovi il membro dallo spazio di lavoro
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Chiavi API

Monitora e gestisci le chiavi API:

Shell

# Elenca le chiavi API
curl "https://api.anthropic.com/v1/organizations/api_keys?limit=10&status=active&workspace_id=wrkspc_xxx" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Aggiorna la chiave API
curl --request POST "https://api.anthropic.com/v1/organizations/api_keys/{api_key_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

Accesso alle informazioni dell'organizzazione

Ottieni informazioni sulla tua organizzazione programmaticamente con l'endpoint /v1/organizations/me.

Ad esempio:

curl "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

{
  "id": "12345678-1234-5678-1234-567812345678",
  "type": "organization",
  "name": "Organization Name"
}

Questo endpoint è utile per determinare programmaticamente a quale organizzazione appartiene una chiave Admin API.

Per i dettagli completi dei parametri e gli schemi di risposta, vedi il riferimento dell'API Informazioni organizzazione.

Accesso ai rapporti di utilizzo e costi

Per accedere ai rapporti di utilizzo e costi della tua organizzazione, utilizza gli endpoint dell'API Utilizzo e costi:

L'endpoint Utilizzo (/v1/organizations/usage_report/messages) fornisce dati di utilizzo dettagliati, inclusi i conteggi dei token e le metriche delle richieste, raggruppati per varie dimensioni come spazio di lavoro, utente e modello.
L'endpoint Costi (/v1/organizations/cost_report) fornisce dati sui costi associati all'utilizzo della tua organizzazione, consentendoti di tracciare le spese e allocare i costi per spazio di lavoro o descrizione.

Questi endpoint forniscono informazioni dettagliate sull'utilizzo della tua organizzazione e sui costi associati.

Accesso all'analisi di Claude Code

Per le organizzazioni che utilizzano Claude Code, l'API di analisi di Claude Code fornisce metriche di produttività dettagliate e informazioni sull'utilizzo:

L'endpoint di analisi di Claude Code (/v1/organizations/usage_report/claude_code) fornisce metriche aggregate giornaliere per l'utilizzo di Claude Code, incluse sessioni, righe di codice, commit, richieste pull, statistiche di utilizzo degli strumenti e dati sui costi suddivisi per utente e modello.

Questa API ti consente di tracciare la produttività degli sviluppatori, analizzare l'adozione di Claude Code e creare dashboard personalizzati per la tua organizzazione.

Best practice

Per utilizzare efficacemente l'Admin API:

Utilizza nomi e descrizioni significativi per gli spazi di lavoro e le chiavi API
Implementa una gestione degli errori appropriata per le operazioni non riuscite
Controlla regolarmente i ruoli e le autorizzazioni dei membri
Pulisci gli spazi di lavoro inutilizzati e gli inviti scaduti
Monitora l'utilizzo delle chiavi API e ruota le chiavi periodicamente

Come funziona l'Admin API

Ruoli e autorizzazioni dell'organizzazione

Concetti chiave

Membri dell'organizzazione

Inviti dell'organizzazione

Spazi di lavoro

Membri dello spazio di lavoro

Chiavi API

Accesso alle informazioni dell'organizzazione

Accesso ai rapporti di utilizzo e costi

Accesso all'analisi di Claude Code

Best practice

Domande frequenti

Quali autorizzazioni sono necessarie per utilizzare l'Admin API?

Posso creare nuove chiavi API tramite l'Admin API?

Cosa succede alle chiavi API quando si rimuove un utente?

Gli amministratori dell'organizzazione possono essere rimossi tramite l'API?

Quanto durano gli inviti dell'organizzazione?

Ci sono limiti agli spazi di lavoro?

Cos'è lo spazio di lavoro predefinito?

Come i ruoli dell'organizzazione influenzano l'accesso allo spazio di lavoro?

Quali ruoli possono essere assegnati negli spazi di lavoro?

I ruoli dello spazio di lavoro dei membri amministratori o di fatturazione dell'organizzazione possono essere modificati?

Cosa succede all'accesso allo spazio di lavoro quando i ruoli dell'organizzazione cambiano?