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 vous permet de gérer programmatiquement les ressources de votre organisation, y compris les membres de l’organisation, les espaces de travail et les clés API. Cela fournit un contrôle programmatique sur les tâches administratives qui nécessiteraient autrement une configuration manuelle dans la Console Anthropic.
L’API Admin nécessite un accès spécial
L’API Admin nécessite une clé API Admin spéciale (commençant par sk-ant-admin...) qui diffère des clés API standard. Seuls les membres de l’organisation avec le rôle admin peuvent provisionner des clés API Admin via la Console Anthropic.
Vous pouvez lister les membres de l’organisation, mettre à jour les rôles des membres et supprimer des membres.
# Lister les membres de l'organisationcurl"https://api.anthropic.com/v1/organizations/users?limit=10"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"# Mettre à jour le rôle d'un membrecurl"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"}'# Supprimer un membrecurl--request DELETE "https://api.anthropic.com/v1/organizations/users/{user_id}"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"
# Créer un espace de travailcurl--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"}'# Lister les espaces de travailcurl"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"# Archiver un espace de travailcurl--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"
Gérez l’accès des utilisateurs à des espaces de travail spécifiques :
# Ajouter un membre à l'espace de travailcurl--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"}'# Lister les membres de l'espace de travailcurl"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"# Mettre à jour le rôle d'un membrecurl--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"}'# Supprimer un membre de l'espace de travailcurl--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"
# Lister les clés APIcurl"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"# Mettre à jour une clé APIcurl--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"}'
Seuls les membres de l’organisation avec le rôle admin peuvent utiliser l’API Admin. Ils doivent également avoir une clé API Admin spéciale (commençant par sk-ant-admin).
Non, les nouvelles clés API ne peuvent être créées que via la Console Anthropic pour des raisons de sécurité. L’API Admin ne peut que gérer les clés API existantes.
Les clés API persistent dans leur état actuel car elles sont liées à l’Organisation, pas aux utilisateurs individuels.
Non, les membres de l’organisation avec le rôle admin ne peuvent pas être supprimés via l’API pour des raisons de sécurité.
Les invitations d’organisation expirent après 21 jours. Il n’y a actuellement aucun moyen de modifier cette période d’expiration.
Oui, vous pouvez avoir un maximum de 100 espaces de travail par Organisation. Les espaces de travail archivés ne comptent pas dans cette limite.
Chaque Organisation a un “Espace de travail par défaut” qui ne peut pas être modifié ou supprimé, et n’a pas d’ID. Cet Espace de travail n’apparaît pas dans les endpoints de liste des espaces de travail.
Les administrateurs d’organisation obtiennent automatiquement le rôle workspace_admin pour tous les espaces de travail. Les membres de facturation d’organisation obtiennent automatiquement le rôle workspace_billing. Les utilisateurs et développeurs d’organisation doivent être ajoutés manuellement à chaque espace de travail.
Les utilisateurs et développeurs d’organisation peuvent se voir assigner les rôles workspace_admin, workspace_developer, ou workspace_user. Le rôle workspace_billing ne peut pas être assigné manuellement - il est hérité du fait d’avoir le rôle d’organisation billing.
Seuls les membres de facturation d’organisation peuvent voir leur rôle d’espace de travail promu au rôle admin. Sinon, les administrateurs d’organisation et les membres de facturation ne peuvent pas voir leurs rôles d’espace de travail modifiés ou être supprimés des espaces de travail tant qu’ils détiennent ces rôles d’organisation. Leur accès aux espaces de travail doit être modifié en changeant d’abord leur rôle d’organisation.
Si un administrateur d’organisation ou un membre de facturation est rétrogradé à utilisateur ou développeur, ils perdent l’accès à tous les espaces de travail sauf ceux où ils ont été assignés manuellement des rôles. Lorsque les utilisateurs sont promus aux rôles admin ou billing, ils obtiennent automatiquement l’accès à tous les espaces de travail.
Les administrateurs d’organisation obtiennent automatiquement le rôle
workspace_adminpour tous les espaces de travail. Les membres de facturation d’organisation obtiennent automatiquement le rôleworkspace_billing. Les utilisateurs et développeurs d’organisation doivent être ajoutés manuellement à chaque espace de travail.