Visão geral da Admin 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 Admin API 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 Claude Console.

A Admin API requer acesso especial

A Admin API requer uma chave Admin API 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 administrador podem provisionar chaves Admin API através do Claude Console.

Como a Admin API funciona

Quando você usa a Admin API:

Você faz solicitações usando sua chave Admin API no cabeçalho x-api-key
A API permite que você gerencie:
- Membros da organização e suas funções
- Convites de membros da organização
- Espaços de trabalho e seus membros
- Chaves de API

Isso é útil para:

Automatizar integração/desintegração de usuários
Gerenciar programaticamente o acesso ao espaço de trabalho
Monitorar e gerenciar o uso de chaves de API

Funções e permissões da organização

Existem cinco funções no nível da organização. Veja mais detalhes aqui.

Função	Permissões
user	Pode usar Workbench
claude_code_user	Pode usar Workbench e Claude Code
developer	Pode usar Workbench e gerenciar chaves de API
billing	Pode usar Workbench e gerenciar detalhes de faturamento
admin	Pode fazer tudo acima, além de gerenciar usuários

Conceitos-chave

Membros da Organização

Você pode listar membros da organização, atualizar funções de membros e remover membros.

Shell

# List organization members
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Update member role
curl "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"}'

# Remove member
curl --request DELETE "https://api.anthropic.com/v1/organizations/users/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Convites da Organização

Você pode convidar usuários para organizações e gerenciar esses convites.

Shell

# Create invite
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "email": "[email protected]",
    "role": "developer"
  }'

# List invites
curl "https://api.anthropic.com/v1/organizations/invites?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Delete invite
curl --request DELETE "https://api.anthropic.com/v1/organizations/invites/{invite_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Espaços de Trabalho

Crie e gerencie espaços de trabalho (console) para organizar seus recursos:

Shell

# Create workspace
curl --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"}'

# List workspaces
curl "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"

# Archive workspace
curl --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"

Membros do Espaço de Trabalho

Gerencie acesso do usuário a espaços de trabalho específicos:

Shell

# Add member to workspace
curl --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"
  }'

# List workspace members
curl "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"

# Update member role
curl --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"
  }'

# Remove member from workspace
curl --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"

Chaves de API

Monitore e gerencie chaves de API:

Shell

# List API keys
curl "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"

# Update API key
curl --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"
  }'

Acessando informações da organização

Obtenha informações sobre sua organização programaticamente com o endpoint /v1/organizations/me.

Por exemplo:

curl "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

{
  "id": "12345678-1234-5678-1234-567812345678",
  "type": "organization",
  "name": "Organization Name"
}

Este endpoint é útil para determinar programaticamente qual organização uma chave Admin API pertence.

Para detalhes completos de parâmetros e esquemas de resposta, consulte a referência da API de Informações da Organização.

Acessando relatórios de uso e custo

Para acessar relatórios de uso e custo da sua organização, use os endpoints da API de Uso e Custo:

O endpoint de Uso (/v1/organizations/usage_report/messages) fornece dados de uso detalhados, incluindo contagens de tokens e métricas de solicitação, agrupados por várias dimensões, como espaço de trabalho, usuário e modelo.
O endpoint de Custo (/v1/organizations/cost_report) fornece dados de custo associados ao uso da sua organização, permitindo que você rastreie despesas e aloque custos por espaço de trabalho ou descrição.

Esses endpoints fornecem insights detalhados sobre o uso da sua organização e custos associados.

Acessando análises do Claude Code

Para organizações que usam Claude Code, a API de Análises do Claude Code fornece métricas de produtividade detalhadas e insights de uso:

O endpoint de Análises do Claude Code (/v1/organizations/usage_report/claude_code) fornece métricas agregadas diariamente para uso do Claude Code, incluindo sessões, linhas de código, commits, solicitações de pull, estatísticas de uso de ferramentas e dados de custo divididos por usuário e modelo.

Esta API permite que você rastreie a produtividade do desenvolvedor, analise a adoção do Claude Code e crie painéis personalizados para sua organização.

Melhores práticas

Para usar efetivamente a Admin API:

Use nomes e descrições significativos para espaços de trabalho e chaves de API
Implemente tratamento de erros adequado para operações com falha
Audite regularmente funções e permissões de membros
Limpe espaços de trabalho não utilizados e convites expirados
Monitore o uso de chaves de API e rotacione as chaves periodicamente

Como a Admin API funciona

Funções e permissões da organização

Conceitos-chave

Membros da Organização

Convites da Organização

Espaços de Trabalho

Membros do Espaço de Trabalho

Chaves de API

Acessando informações da organização

Acessando relatórios de uso e custo

Acessando análises do Claude Code

Melhores práticas

Perguntas frequentes

Quais permissões são necessárias para usar a Admin API?

Posso criar novas chaves de API através da Admin API?

O que acontece com as chaves de API ao remover um usuário?

Os administradores da organização podem ser removidos via API?

Quanto tempo os convites da organização duram?

Existem limites em espaços de trabalho?

O que é o Espaço de Trabalho Padrão?

Como as funções da organização afetam o acesso ao Espaço de Trabalho?

Quais funções podem ser atribuídas em espaços de trabalho?

As funções de espaço de trabalho dos membros de administrador ou faturamento da organização podem ser alteradas?

O que acontece com o acesso ao espaço de trabalho quando as funções da organização mudam?