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 de Administração permite que você gerencie programaticamente os recursos da sua organização, incluindo membros da organização, espaços de trabalho e chaves de API. Isso fornece controle programático sobre tarefas administrativas que, de outra forma, exigiriam configuração manual no Console da Anthropic.
A API de Administração requer acesso especial
A API de Administração requer uma chave de API de Administração especial (começando com sk-ant-admin...) que difere das chaves de API padrão. Apenas membros da organização com função de administrador podem provisionar chaves de API de Administração através do Console da Anthropic.
# Criar espaço de trabalhocurl--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"}'# Listar espaços de trabalhocurl"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"# Arquivar espaço de trabalhocurl--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"
Gerencie o acesso do usuário a espaços de trabalho específicos:
# Adicionar membro ao espaço de trabalhocurl--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 espaço de trabalhocurl"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 espaço de trabalhocurl--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 função de administrador podem usar a API de Administração. Eles também devem ter uma chave de API de Administração especial (começando com sk-ant-admin).
Não, novas chaves de API só podem ser criadas através do Console da Anthropic por motivos de segurança. A API de Administração só pode 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 função de administrador não podem ser removidos via API por motivos de segurança.
Os convites da organização expiram após 21 dias. Atualmente, não há como modificar esse período de expiração.
Sim, você pode ter no máximo 100 espaços de trabalho por Organização. Espaços de trabalho arquivados não contam para esse limite.
Cada Organização tem um “Espaço de Trabalho Padrão” que não pode ser editado ou removido, e não possui ID. Este Espaço de Trabalho não aparece nos endpoints de listagem de espaços de trabalho.
Administradores da organização automaticamente recebem a função workspace_admin para todos os espaços de trabalho. Membros de faturamento da organização automaticamente recebem a função workspace_billing. Usuários e desenvolvedores da organização devem ser adicionados manualmente a cada espaço de trabalho.
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 billing na organização.
Apenas membros de faturamento da organização podem ter sua função de espaço de trabalho atualizada para uma função de administrador. Caso contrário, administradores e membros de faturamento da organização não podem ter suas funções de espaço de trabalho alteradas ou serem removidos dos espaços de trabalho enquanto mantiverem essas funções na organização. O acesso ao espaço de trabalho deve ser modificado alterando primeiro a função na organização.
Se um administrador ou membro de faturamento da organização for rebaixado para usuário ou desenvolvedor, eles perdem acesso a todos os espaços de trabalho, exceto aqueles onde foram manualmente atribuídas funções. Quando os usuários são promovidos a funções de administrador ou faturamento, eles ganham acesso automático a todos os espaços de trabalho.