The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
L’API Admin ti permette di gestire programmaticamente le risorse della tua organizzazione, inclusi i membri dell’organizzazione, gli spazi di lavoro e le chiavi API. Questo fornisce un controllo programmatico su attività amministrative che altrimenti richiederebbero una configurazione manuale nella Console Anthropic.
L’API Admin richiede un accesso speciale
L’API Admin richiede una chiave API Admin speciale (che inizia con sk-ant-admin...) che differisce dalle chiavi API standard. Solo i membri dell’organizzazione con ruolo di amministratore possono fornire chiavi API Admin attraverso la Console Anthropic.
Puoi elencare i membri dell’organizzazione, aggiornare i ruoli dei membri e rimuovere membri.
# Elencare i membri dell'organizzazionecurl"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 di un membrocurl"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 un membrocurl--request DELETE "https://api.anthropic.com/v1/organizations/users/{user_id}"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"
Crea e gestisci spazi di lavoro per organizzare le tue risorse:
# Creare uno spazio di lavorocurl--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"}'# Elencare gli spazi di lavorocurl"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"# Archiviare uno spazio di lavorocurl--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"
Gestisci l’accesso degli utenti a specifici spazi di lavoro:
# Aggiungere un membro a uno spazio di lavorocurl--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 di uno spazio di lavorocurl"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 di un membrocurl--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 da uno spazio di lavorocurl--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"
Solo i membri dell’organizzazione con ruolo di amministratore possono utilizzare l’API Admin. Devono anche avere una chiave API Admin speciale (che inizia con sk-ant-admin).
No, le nuove chiavi API possono essere create solo attraverso la Console Anthropic per motivi di sicurezza. L’API Admin può solo gestire le chiavi API esistenti.
Le chiavi API persistono nel loro stato attuale poiché sono associate all’Organizzazione, non ai singoli utenti.
No, i membri dell’organizzazione con ruolo di amministratore non possono essere rimossi tramite l’API per motivi di sicurezza.
Gli inviti all’organizzazione scadono dopo 21 giorni. Attualmente non c’è modo di modificare questo periodo di scadenza.
Sì, puoi avere un massimo di 100 spazi di lavoro per Organizzazione. Gli spazi di lavoro archiviati non contano ai fini di questo limite.
Ogni Organizzazione ha uno “Spazio di Lavoro Predefinito” che non può essere modificato o rimosso, e non ha un ID. Questo Spazio di Lavoro non appare negli endpoint di elenco degli spazi di lavoro.
Gli amministratori dell’organizzazione ottengono automaticamente il ruolo workspace_admin per tutti gli spazi di lavoro. I membri di fatturazione dell’organizzazione ottengono automaticamente il ruolo workspace_billing. Gli utenti e gli sviluppatori dell’organizzazione devono essere aggiunti manualmente a ciascuno spazio di lavoro.
Agli utenti e agli sviluppatori dell’organizzazione possono essere assegnati i ruoli workspace_admin, workspace_developer o workspace_user. Il ruolo workspace_billing non può essere assegnato manualmente - viene ereditato dall’avere il ruolo billing nell’organizzazione.
Solo i membri di fatturazione dell’organizzazione possono avere il loro ruolo di spazio di lavoro aggiornato a un ruolo di amministratore. Altrimenti, gli amministratori e i membri di fatturazione dell’organizzazione non possono avere i loro ruoli di spazio di lavoro modificati o essere rimossi dagli spazi di lavoro mentre mantengono quei ruoli nell’organizzazione. Il loro accesso agli spazi di lavoro deve essere modificato cambiando prima il loro ruolo nell’organizzazione.
Se un amministratore o un membro di fatturazione dell’organizzazione viene declassato a utente o sviluppatore, perde l’accesso a tutti gli spazi di lavoro tranne quelli in cui gli sono stati assegnati manualmente dei ruoli. Quando gli utenti vengono promossi a ruoli di amministratore o fatturazione, ottengono automaticamente l’accesso a tutti gli spazi di lavoro.
