AmministrazioneOrganizzazione

Admin API

L'Admin API non è disponibile per gli account individuali. Per collaborare con i colleghi e aggiungere membri, configura la tua organizzazione in Console → Settings → Organization.

L'Admin API ti consente di gestire in modo programmatico le risorse della tua organizzazione, inclusi i membri dell'organizzazione, i workspace e le chiavi API. Questo fornisce un controllo programmatico sulle 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...) diversa dalle chiavi API standard. Solo i membri dell'organizzazione con il ruolo di admin possono generare chiavi Admin API tramite la Claude Console.

Claude Platform su AWS: La maggior parte dell'Admin API non è disponibile su Claude Platform su AWS. Gli endpoint dei workspace (create, get, list, update e archive su /v1/organizations/workspaces) sono disponibili. Altri endpoint, inclusi quelli per i membri dell'organizzazione, i membri dei workspace, gli inviti, le chiavi API, i report di utilizzo, i report dei costi e i report dei limiti di velocità, non sono disponibili. Consulta Claude Platform su AWS per i dettagli.

Come funziona l'Admin API

Quando usi l'Admin API:

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

Questo è utile per:

Automatizzare l'onboarding/offboarding degli utenti
Gestire in modo programmatico l'accesso ai workspace
Monitorare e gestire l'utilizzo delle chiavi API

Ruoli e autorizzazioni dell'organizzazione

Esistono cinque ruoli a livello di organizzazione. Consulta maggiori dettagli nell'articolo Ruoli e autorizzazioni della Console API.

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

Concetti chiave

Membri dell'organizzazione

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

cURL

# 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 "content-type: application/json" \
  --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 all'organizzazione

Puoi invitare utenti nelle organizzazioni e gestire tali inviti.

cURL

# Crea invito
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --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"

Workspace

Per una guida completa ai workspace, inclusi esempi per la Console e l'API, consulta Workspace.

Membri dei workspace

Gestisci l'accesso degli utenti a workspace specifici:

cURL

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

# Elenca i membri del workspace
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 "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "workspace_role": "workspace_admin"
  }'

# Rimuovi il membro dal workspace
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:

cURL

# 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 "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

Accesso alle informazioni dell'organizzazione

Ottieni informazioni sulla tua organizzazione in modo programmatico con l'endpoint /v1/organizations/me.

Ad esempio:

cURL

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

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

Questo endpoint è utile per determinare in modo programmatico a quale organizzazione appartiene una chiave Admin API.

Per i dettagli completi sui parametri e gli schemi di risposta, consulta il riferimento API Organization Info.

Report di utilizzo e costi

Monitora l'utilizzo e i costi della tua organizzazione con l'API Usage and Cost.

Analytics di Claude Code

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

Limiti di velocità

Leggi i limiti di velocità configurati per la tua organizzazione e i suoi workspace con l'API Rate Limits.

Compliance API

Recupera i dati di audit e attività per la tua organizzazione con la Compliance API. Le chiavi Admin API possono leggere solo l'Activity Feed; per l'accesso completo, consulta Ottenere l'accesso alla Compliance API.

Best practice

Per utilizzare efficacemente l'Admin API:

Usa nomi e descrizioni significativi per workspace e chiavi API
Implementa una corretta gestione degli errori per le operazioni non riuscite
Verifica regolarmente i ruoli e le autorizzazioni dei membri
Elimina i workspace inutilizzati e gli inviti scaduti
Monitora l'utilizzo delle chiavi API e ruota le chiavi periodicamente

FAQ

Per domande specifiche sui workspace, consulta le FAQ sui Workspace.

Was this page helpful?

AmministrazioneOrganizzazione

Admin API

L'Admin API non è disponibile per gli account individuali. Per collaborare con i colleghi e aggiungere membri, configura la tua organizzazione in Console → Settings → Organization.

L'Admin API richiede un accesso speciale

Come funziona l'Admin API

Quando usi l'Admin API:

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

Questo è utile per:

Automatizzare l'onboarding/offboarding degli utenti
Gestire in modo programmatico l'accesso ai workspace
Monitorare e gestire l'utilizzo delle chiavi API

Ruoli e autorizzazioni dell'organizzazione

Esistono cinque ruoli a livello di organizzazione. Consulta maggiori dettagli nell'articolo Ruoli e autorizzazioni della Console API.

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

Concetti chiave

Membri dell'organizzazione

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

cURL

# 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 "content-type: application/json" \
  --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 all'organizzazione

Puoi invitare utenti nelle organizzazioni e gestire tali inviti.

cURL

# Crea invito
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --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"

Workspace

Per una guida completa ai workspace, inclusi esempi per la Console e l'API, consulta Workspace.

Membri dei workspace

Gestisci l'accesso degli utenti a workspace specifici:

cURL

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

# Elenca i membri del workspace
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 "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "workspace_role": "workspace_admin"
  }'

# Rimuovi il membro dal workspace
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:

cURL

# 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 "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

Accesso alle informazioni dell'organizzazione

Ottieni informazioni sulla tua organizzazione in modo programmatico con l'endpoint /v1/organizations/me.

Ad esempio:

cURL

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

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

Questo endpoint è utile per determinare in modo programmatico a quale organizzazione appartiene una chiave Admin API.

Per i dettagli completi sui parametri e gli schemi di risposta, consulta il riferimento API Organization Info.

Report di utilizzo e costi

Monitora l'utilizzo e i costi della tua organizzazione con l'API Usage and Cost.

Analytics di Claude Code

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

Limiti di velocità

Leggi i limiti di velocità configurati per la tua organizzazione e i suoi workspace con l'API Rate Limits.

Compliance API

Best practice

Per utilizzare efficacemente l'Admin API:

Usa nomi e descrizioni significativi per workspace e chiavi API
Implementa una corretta gestione degli errori per le operazioni non riuscite
Verifica regolarmente i ruoli e le autorizzazioni dei membri
Elimina i workspace inutilizzati e gli inviti scaduti
Monitora l'utilizzo delle chiavi API e ruota le chiavi periodicamente

FAQ

Per domande specifiche sui workspace, consulta le FAQ sui Workspace.

Was this page helpful?

Come funziona l'Admin API

Ruoli e autorizzazioni dell'organizzazione

Concetti chiave

Membri dell'organizzazione

Inviti all'organizzazione

Workspace

Membri dei workspace

Chiavi API

Accesso alle informazioni dell'organizzazione

Report di utilizzo e costi

Analytics di Claude Code

Limiti di velocità

Compliance API

Best practice

FAQ

Quali autorizzazioni sono necessarie per usare l'Admin API?

Posso creare nuove chiavi API tramite l'Admin API?

Cosa succede alle chiavi API quando si rimuove un utente?

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

Quanto durano gli inviti all'organizzazione?

Come funziona l'Admin API

Ruoli e autorizzazioni dell'organizzazione

Concetti chiave

Membri dell'organizzazione

Inviti all'organizzazione

Workspace

Membri dei workspace

Chiavi API

Accesso alle informazioni dell'organizzazione

Report di utilizzo e costi

Analytics di Claude Code

Limiti di velocità

Compliance API

Best practice

FAQ

Quali autorizzazioni sono necessarie per usare l'Admin API?

Posso creare nuove chiavi API tramite l'Admin API?

Cosa succede alle chiavi API quando si rimuove un utente?

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

Quanto durano gli inviti all'organizzazione?