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 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 sui compiti amministrativi che altrimenti richiederebbero configurazione manuale nella Console Anthropic.
L’API Admin richiede 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 il ruolo di admin possono fornire chiavi API Admin attraverso la Console Anthropic.
# 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"
# 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 del 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 il ruolo di admin possono usare 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 chiavi API esistenti.
Le chiavi API persistono nel loro stato attuale poiché sono limitate all’Organizzazione, non ai singoli utenti.
No, i membri dell’organizzazione con il ruolo di 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 tranne quelli dove sono stati assegnati ruoli manualmente. Quando gli utenti vengono promossi a ruoli admin o billing, ottengono accesso automatico a tutti gli spazi di lavoro.