Amministrazione e monitoraggio

Panoramica dell'Admin API

Gestisci programmaticamente le risorse della tua organizzazione, inclusi i membri, gli spazi di lavoro e le chiavi 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 chiave Admin API speciale (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 allo spazio di lavoro
Monitorare e gestire l'utilizzo delle chiavi API

Ruoli e autorizzazioni dell'organizzazione

Ci sono cinque ruoli a livello di organizzazione. Vedi più 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 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 questi inviti.

Shell

# Crea 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 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 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

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

Shell

# Crea 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 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 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 dell'utente a spazi di lavoro specifici:

Shell

# Aggiungi 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 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 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 Organization Info.

Accesso ai rapporti di utilizzo e costo

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

L'endpoint di 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 di costo (/v1/organizations/cost_report) fornisce dati di costo 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 Claude Code Analytics fornisce metriche di produttività dettagliate e informazioni sull'utilizzo:

L'endpoint Claude Code Analytics (/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 di costo 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

FAQ

Amministrazione e monitoraggio

Panoramica dell'Admin API

Gestisci programmaticamente le risorse della tua organizzazione, inclusi i membri, gli spazi di lavoro e le chiavi 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 richiede un accesso speciale

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 allo spazio di lavoro
Monitorare e gestire l'utilizzo delle chiavi API

Ruoli e autorizzazioni dell'organizzazione

Ci sono cinque ruoli a livello di organizzazione. Vedi più 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 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 questi inviti.

Shell

# Crea 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 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 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

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

Shell

# Crea 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 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 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 dell'utente a spazi di lavoro specifici:

Shell

# Aggiungi 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 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 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 Organization Info.

Accesso ai rapporti di utilizzo e costo

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

L'endpoint di 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 di costo (/v1/organizations/cost_report) fornisce dati di costo 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 Claude Code Analytics fornisce metriche di produttività dettagliate e informazioni sull'utilizzo:

L'endpoint Claude Code Analytics (/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 di costo 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 costo

Accesso all'analisi di Claude Code

Best practice

FAQ

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?

Qual è lo spazio di lavoro predefinito?

Come influiscono i ruoli dell'organizzazione sull'accesso allo spazio di lavoro?

Quali ruoli possono essere assegnati negli spazi di lavoro?

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 costo

Accesso all'analisi di Claude Code

Best practice

FAQ

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?

Qual è lo spazio di lavoro predefinito?

Come influiscono i ruoli dell'organizzazione sull'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?