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.
Crea e gestisci spazi di lavoro per organizzare le tue risorse:
# Crea 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"}'# Elenca 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"# Archivia 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 spazi di lavoro specifici:
# Aggiungi membro allo 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"}'# Elenca membri dello 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"# Aggiorna ruolo 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"}'# Rimuovi membro dallo 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 admin possono usare l’Admin API. Devono anche avere una chiave Admin API 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’Admin API può solo gestire 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 admin non possono essere rimossi tramite l’API per motivi di sicurezza.
Gli inviti dell’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 verso questo limite.
Ogni Organizzazione ha uno “Spazio di Lavoro Predefinito” che non può essere modificato o rimosso, e non ha ID. Questo Spazio di Lavoro non appare negli endpoint di elenco degli spazi di lavoro.
Gli admin dell’organizzazione ottengono automaticamente il ruolo workspace_admin per tutti gli spazi di lavoro. I membri billing dell’organizzazione ottengono automaticamente il ruolo workspace_billing. Gli utenti e sviluppatori dell’organizzazione devono essere aggiunti manualmente a ogni spazio di lavoro.
Gli utenti e sviluppatori dell’organizzazione possono essere assegnati ai ruoli workspace_admin, workspace_developer, o workspace_user. Il ruolo workspace_billing non può essere assegnato manualmente - è ereditato dall’avere il ruolo billing dell’organizzazione.
Solo i membri billing dell’organizzazione possono avere il loro ruolo dello spazio di lavoro aggiornato a un ruolo admin. Altrimenti, gli admin e i membri billing dell’organizzazione non possono avere i loro ruoli degli spazi di lavoro cambiati o essere rimossi dagli spazi di lavoro mentre mantengono quei ruoli dell’organizzazione. Il loro accesso agli spazi di lavoro deve essere modificato cambiando prima il loro ruolo dell’organizzazione.
Se un admin o membro billing dell’organizzazione viene retrocesso a utente o sviluppatore, perde l’accesso a tutti gli spazi di lavoro eccetto quelli dove erano stati assegnati ruoli manualmente. Quando gli utenti vengono promossi a ruoli admin o billing, ottengono accesso automatico a tutti gli spazi di lavoro.