Admin API

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 controllo programmatico sulle attività amministrative che altrimenti richiederebbero una configurazione manuale nella Claude Console.



Autenticazione

Autenticati con una delle due credenziali. Gli esempi seguenti chiamano l'endpoint delle informazioni sull'organizzazione in entrambi i modi:

OAuth bearer:

curl --fail-with-body -sS "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"

Un token org:admin concede l'accesso all'intera organizzazione, indipendentemente dal workspace a cui è associato il profilo o la regola di federazione sottostante. Per ottenerne uno, consulta i prerequisiti in Gestire WIF con l'Admin API.

Chiave Admin API:

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



Come funziona l'Admin API

Quando usi l'Admin API:

1. Effettui richieste utilizzando una delle credenziali descritte nella sezione Autenticazione
2. 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
   • Service account, federation issuer e federation rule (questi endpoint richiedono un token OAuth org:admin; le chiavi Admin API non sono accettate)

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 permessi dell'organizzazione

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

Gli owner e i primary owner dell'organizzazione hanno tutti i permessi di admin e possono inoltre gestire gli admin. Tutti i riferimenti al ruolo admin in questa pagina si applicano anche agli owner e ai primary owner.



Concetti chiave



Membri dell'organizzazione

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

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

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

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

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



Service account

Crea e gestisci i service account (svac_...), le identità non umane per conto delle quali agiscono i token di Workload Identity Federation. Le chiavi Admin API non sono accettate sugli endpoint di service account, federation issuer o federation rule; usa un token OAuth org:admin. Consulta Gestire WIF con l'Admin API.



Federation issuer

Registra gli identity provider OIDC (fdis_...) i cui token possono asserire l'identità del workload per la tua organizzazione. Consulta Gestire WIF con l'Admin API.



Federation rule

Gestisci le regole (fdrl_...) che mappano i token degli issuer ai service account e agli scope. Consulta Gestire WIF con l'Admin API.



Accesso alle informazioni sull'organizzazione

Ottieni informazioni sulla tua organizzazione in modo programmatico 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: $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 usare 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 i permessi 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.