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 par programmation les ressources de votre organisation, y compris les membres de l’organisation, les espaces de travail et les clés API. Cela offre 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 ayant le rôle d’administrateur peuvent fournir 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 à un 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 d'un 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 d'un 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 ayant le rôle d’administrateur peuvent utiliser l’API Admin. Ils doivent également disposer d’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, et non aux utilisateurs individuels.
Non, les membres de l’organisation ayant le rôle d’administrateur ne peuvent pas être supprimés via l’API pour des raisons de sécurité.
Les invitations à l’organisation expirent après 21 jours. Il n’existe 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 sont pas comptabilisés dans cette limite.
Chaque Organisation possède un “Espace de travail par défaut” qui ne peut pas être modifié ou supprimé, et qui n’a pas d’ID. Cet Espace de travail n’apparaît pas dans les points de terminaison de liste des espaces de travail.
Les administrateurs de l’organisation obtiennent automatiquement le rôle workspace_admin pour tous les espaces de travail. Les membres de facturation de l’organisation obtiennent automatiquement le rôle workspace_billing. Les utilisateurs et développeurs de l’organisation doivent être ajoutés manuellement à chaque espace de travail.
Les utilisateurs et développeurs de l’organisation peuvent se voir attribuer les rôles workspace_admin, workspace_developer ou workspace_user. Le rôle workspace_billing ne peut pas être attribué manuellement - il est hérité du rôle billing de l’organisation.
Seuls les membres de facturation de l’organisation peuvent voir leur rôle d’espace de travail mis à niveau vers un rôle d’administrateur. Sinon, les administrateurs et les membres de facturation de l’organisation ne peuvent pas voir leurs rôles d’espace de travail modifiés ou être supprimés des espaces de travail tant qu’ils conservent ces rôles d’organisation. Leur accès à l’espace de travail doit être modifié en changeant d’abord leur rôle d’organisation.
Si un administrateur ou un membre de facturation de l’organisation est rétrogradé au statut d’utilisateur ou de développeur, il perd l’accès à tous les espaces de travail, sauf ceux où des rôles lui ont été attribués manuellement. Lorsque des utilisateurs sont promus aux rôles d’administrateur ou de facturation, ils obtiennent automatiquement l’accès à tous les espaces de travail.
Les administrateurs de l’organisation obtiennent automatiquement le rôle
workspace_adminpour tous les espaces de travail. Les membres de facturation de l’organisation obtiennent automatiquement le rôleworkspace_billing. Les utilisateurs et développeurs de l’organisation doivent être ajoutés manuellement à chaque espace de travail.