Panoramica Admin API

Amministrazione

Panoramica dell'Admin API

Gestisci programmaticamente i membri dell'organizzazione, gli spazi di lavoro e le chiavi API utilizzando l'Admin API di Anthropic.

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 ulteriori dettagli nell'articolo Ruoli e autorizzazioni della console API.

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

# Elencare 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"

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

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

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

# Elencare 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"

# Eliminare 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, inclusi esempi di Console e API, vedi Spazi di lavoro.

Membri dello spazio di lavoro

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

Shell

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

# Elencare 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"

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

# Rimuovere un 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

# Elencare 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"

# Aggiornare 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 API Informazioni organizzazione.

Rapporti di utilizzo e costi

Traccia l'utilizzo e i costi della tua organizzazione con l'API di utilizzo e costi.

Analitiche di Claude Code

Monitora la produttività degli sviluppatori e l'adozione di Claude Code con l'API di analitiche di Claude Code.

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

Domande frequenti

Per domande specifiche dello spazio di lavoro, vedi le Domande frequenti su spazi di lavoro.

Was this page helpful?

Amministrazione

Panoramica dell'Admin API

Gestisci programmaticamente i membri dell'organizzazione, gli spazi di lavoro e le chiavi API utilizzando l'Admin API di Anthropic.

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 ulteriori dettagli nell'articolo Ruoli e autorizzazioni della console API.

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

# Elencare 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"

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

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

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

# Elencare 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"

# Eliminare 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, inclusi esempi di Console e API, vedi Spazi di lavoro.

Membri dello spazio di lavoro

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

Shell

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

# Elencare 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"

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

# Rimuovere un 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

# Elencare 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"

# Aggiornare 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 API Informazioni organizzazione.

Rapporti di utilizzo e costi

Traccia l'utilizzo e i costi della tua organizzazione con l'API di utilizzo e costi.

Analitiche di Claude Code

Monitora la produttività degli sviluppatori e l'adozione di Claude Code con l'API di analitiche di Claude Code.

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

Domande frequenti

Per domande specifiche dello spazio di lavoro, vedi le Domande frequenti su spazi di lavoro.

Was this page helpful?

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

Rapporti di utilizzo e costi

Analitiche 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?

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

Rapporti di utilizzo e costi

Analitiche 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?