Aprenda como usar a API Admin para gerenciar programaticamente os recursos da sua organização, incluindo membros, workspaces e chaves de API.
The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
A API Admin permite que você gerencie programaticamente os recursos da sua organização, incluindo membros da organização, workspaces e chaves de API. Isso fornece controle programático sobre tarefas administrativas que, de outra forma, exigiriam configuração manual no Console Anthropic.
A API Admin requer acesso especial
A API Admin requer uma chave de API Admin especial (começando com sk-ant-admin...) que difere das chaves de API padrão. Apenas membros da organização com a função de admin podem provisionar chaves de API Admin através do Console Anthropic.
# Adicionar membro ao workspacecurl--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"}'# Listar membros do workspacecurl"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"# Atualizar função do 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"}'# Remover membro do workspacecurl--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"
Apenas membros da organização com a função de admin podem usar a API Admin. Eles também devem ter uma chave de API Admin especial (começando com sk-ant-admin).
Não, novas chaves de API só podem ser criadas através do Console Anthropic por razões de segurança. A API Admin pode apenas gerenciar chaves de API existentes.
As chaves de API persistem em seu estado atual, pois estão vinculadas à Organização, não a usuários individuais.
Não, membros da organização com a função de admin não podem ser removidos via API por razões de segurança.
Os convites da organização expiram após 21 dias. Atualmente não há como modificar este período de expiração.
Sim, você pode ter no máximo 100 workspaces por Organização. Workspaces arquivados não contam para este limite.
Toda Organização tem um “Workspace Padrão” que não pode ser editado ou removido, e não tem ID. Este Workspace não aparece nos endpoints de lista de workspaces.
Os admins da organização automaticamente recebem a função workspace_admin para todos os workspaces. Os membros de cobrança da organização automaticamente recebem a função workspace_billing. Usuários e desenvolvedores da organização devem ser adicionados manualmente a cada workspace.
Usuários e desenvolvedores da organização podem receber as funções workspace_admin, workspace_developer ou workspace_user. A função workspace_billing não pode ser atribuída manualmente - ela é herdada por ter a função de organização billing.
Apenas membros de cobrança da organização podem ter sua função de workspace promovida para uma função de admin. Caso contrário, admins da organização e membros de cobrança não podem ter suas funções de workspace alteradas ou ser removidos dos workspaces enquanto mantiverem essas funções organizacionais. Seu acesso ao workspace deve ser modificado alterando primeiro sua função organizacional.
Se um admin da organização ou membro de cobrança for rebaixado para usuário ou desenvolvedor, eles perdem acesso a todos os workspaces, exceto aqueles onde foram atribuídas funções manualmente. Quando usuários são promovidos para funções de admin ou cobrança, eles ganham acesso automático a todos os workspaces.