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

L’Admin API richiede 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 ruolo admin possono fornire chiavi Admin API attraverso la Console Anthropic.

Come funziona l’Admin API

Quando usi l’Admin API:

  1. Fai richieste usando la tua chiave Admin API nell’header x-api-key
  2. L’API ti consente di gestire:
    • Membri dell’organizzazione e i loro ruoli
    • Inviti dei membri dell’organizzazione
    • Spazi di lavoro e i loro membri
    • 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 permessi dell’organizzazione

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

RuoloPermessi
userPuò usare Workbench
claude_code_userPuò usare Workbench e Claude Code
developerPuò usare Workbench e gestire le chiavi API
billingPuò usare Workbench e gestire i dettagli di fatturazione
adminPuò 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 membri.

# Elenca 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 ruolo 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 utenti alle organizzazioni e gestire questi inviti.

# 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": "newuser@domain.com",
    "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 spazi di lavoro per organizzare le tue risorse:

# 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 degli utenti a spazi di lavoro specifici:

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

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

Migliori pratiche

Per utilizzare efficacemente l’Admin API:

  • Usa nomi e descrizioni significativi per spazi di lavoro e chiavi API
  • Implementa una gestione appropriata degli errori per operazioni fallite
  • Controlla regolarmente i ruoli e i permessi dei membri
  • Pulisci spazi di lavoro inutilizzati e inviti scaduti
  • Monitora l’utilizzo delle chiavi API e ruota le chiavi periodicamente

FAQ