The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
La API de Administración te permite gestionar programáticamente los recursos de tu organización, incluyendo miembros de la organización, espacios de trabajo y claves API. Esto proporciona control programático sobre tareas administrativas que de otro modo requerirían configuración manual en la Consola de Anthropic.
La API de Administración requiere acceso especialLa API de Administración requiere una clave API de Administración especial (que comienza con sk-ant-admin...) que difiere de las claves API estándar. Solo los miembros de la organización con el rol de administrador pueden aprovisionar claves API de Administración a través de la Consola de Anthropic.

​
Cómo funciona la API de Administración

Cuando usas la API de Administración:
  1. Realizas solicitudes usando tu clave API de Administración en el encabezado x-api-key
  2. La API te permite gestionar:
    • Miembros de la organización y sus roles
    • Invitaciones de miembros de la organización
    • Espacios de trabajo y sus miembros
    • Claves API
Esto es útil para:
  • Automatizar la incorporación/desvinculación de usuarios
  • Gestionar programáticamente el acceso a espacios de trabajo
  • Monitorear y gestionar el uso de claves API

​
Roles y permisos de la organización

Hay cinco roles a nivel de organización. Ve más detalles aquí.
RolPermisos
userPuede usar Workbench
claude_code_userPuede usar Workbench y Claude Code
developerPuede usar Workbench y gestionar claves API
billingPuede usar Workbench y gestionar detalles de facturación
adminPuede hacer todo lo anterior, además de gestionar usuarios

​
Conceptos clave

​
Miembros de la Organización

Puedes listar miembros de la organización, actualizar roles de miembros y eliminar miembros. 
# Listar miembros de la organización
curl "https://api.anthropic.com/v1/organizations/users?limit=10" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Actualizar rol de miembro
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"}'

# Eliminar miembro
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"

​
Invitaciones de la Organización

Puedes invitar usuarios a organizaciones y gestionar esas invitaciones. 
# Crear invitación
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": "newuser@domain.com",
    "role": "developer"
  }'

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

# Eliminar invitación
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"

​
Espacios de Trabajo

Crea y gestiona espacios de trabajo (consola) para organizar tus recursos: 
# Crear espacio de trabajo
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"}'

# Listar espacios de trabajo
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"

# Archivar espacio de trabajo
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"

​
Miembros del Espacio de Trabajo

Gestiona el acceso de usuarios a espacios de trabajo específicos: 
# Agregar miembro al espacio de trabajo
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"
  }'

# Listar miembros del espacio de trabajo
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"

# Actualizar rol de miembro
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"
  }'

# Eliminar miembro del espacio de trabajo
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"

​
Claves API

Monitorea y gestiona claves API: 
# Listar claves API
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"

# Actualizar clave API
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"
  }'

​
Mejores prácticas

Para usar efectivamente la API de Administración:
  • Usa nombres y descripciones significativos para espacios de trabajo y claves API
  • Implementa manejo adecuado de errores para operaciones fallidas
  • Audita regularmente los roles y permisos de miembros
  • Limpia espacios de trabajo no utilizados e invitaciones expiradas
  • Monitorea el uso de claves API y rota las claves periódicamente

​
Preguntas frecuentes