Administración y monitoreo

Descripción general de la API de administración

Descripción general de la API de administración de Anthropic para gestionar miembros de la organización, espacios de trabajo y claves API

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 Claude.

La API de administración requiere acceso especial

La 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 provisionar claves API de administración a través de la Consola Claude.

Cómo funciona la API de administración

Cuando usas la API de administración:

Realizas solicitudes usando tu clave API de administración en el encabezado x-api-key
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/desincorporación de usuarios
Gestionar programáticamente el acceso al espacio 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. Consulta más detalles aquí.

Rol	Permisos
user	Puede usar Workbench
claude_code_user	Puede usar Workbench y Claude Code
developer	Puede usar Workbench y gestionar claves API
billing	Puede usar Workbench y gestionar detalles de facturación
admin	Puede 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.

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"

Invitaciones de la organización

Puedes invitar usuarios a organizaciones y gestionar esas invitaciones.

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"

Espacios de trabajo

Crea y gestiona espacios de trabajo (consola) para organizar tus 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"

Miembros del espacio de trabajo

Gestiona el acceso de usuarios a espacios de trabajo 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"

Claves API

Monitorea y gestiona claves 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"
  }'

Acceso a la información de la organización

Obtén información sobre tu organización programáticamente con el punto final /v1/organizations/me.

Por ejemplo:

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 punto final es útil para determinar programáticamente a qué organización pertenece una clave API de administración.

Para obtener detalles completos de parámetros y esquemas de respuesta, consulta la referencia de la API de información de la organización.

Acceso a informes de uso y costo

Para acceder a informes de uso y costo de tu organización, utiliza los puntos finales de la API de uso y costo:

El punto final de uso (/v1/organizations/usage_report/messages) proporciona datos de uso detallados, incluyendo conteos de tokens y métricas de solicitudes, agrupados por varias dimensiones como espacio de trabajo, usuario y modelo.
El punto final de costo (/v1/organizations/cost_report) proporciona datos de costo asociados con el uso de tu organización, permitiéndote rastrear gastos y asignar costos por espacio de trabajo o descripción.

Estos puntos finales proporcionan información detallada sobre el uso de tu organización y los costos asociados.

Acceso a análisis de Claude Code

Para organizaciones que utilizan Claude Code, la API de análisis de Claude Code proporciona métricas de productividad detalladas e información de uso:

El punto final de análisis de Claude Code (/v1/organizations/usage_report/claude_code) proporciona métricas agregadas diarias para el uso de Claude Code, incluyendo sesiones, líneas de código, confirmaciones, solicitudes de extracción, estadísticas de uso de herramientas y datos de costo desglosados por usuario y modelo.

Esta API te permite rastrear la productividad de los desarrolladores, analizar la adopción de Claude Code y crear paneles personalizados para tu organización.

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 de errores adecuado para operaciones fallidas
Audita regularmente los roles y permisos de los miembros
Limpia espacios de trabajo no utilizados e invitaciones expiradas
Monitorea el uso de claves API y rota las claves periódicamente

Preguntas frecuentes

Administración y monitoreo

Descripción general de la API de administración

Descripción general de la API de administración de Anthropic para gestionar miembros de la organización, espacios de trabajo y claves API

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 requiere acceso especial

Cómo funciona la API de administración

Cuando usas la API de administración:

Realizas solicitudes usando tu clave API de administración en el encabezado x-api-key
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/desincorporación de usuarios
Gestionar programáticamente el acceso al espacio 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. Consulta más detalles aquí.

Rol	Permisos
user	Puede usar Workbench
claude_code_user	Puede usar Workbench y Claude Code
developer	Puede usar Workbench y gestionar claves API
billing	Puede usar Workbench y gestionar detalles de facturación
admin	Puede 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.

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"

Invitaciones de la organización

Puedes invitar usuarios a organizaciones y gestionar esas invitaciones.

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"

Espacios de trabajo

Crea y gestiona espacios de trabajo (consola) para organizar tus 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"

Miembros del espacio de trabajo

Gestiona el acceso de usuarios a espacios de trabajo 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"

Claves API

Monitorea y gestiona claves 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"
  }'

Acceso a la información de la organización

Obtén información sobre tu organización programáticamente con el punto final /v1/organizations/me.

Por ejemplo:

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 punto final es útil para determinar programáticamente a qué organización pertenece una clave API de administración.

Para obtener detalles completos de parámetros y esquemas de respuesta, consulta la referencia de la API de información de la organización.

Acceso a informes de uso y costo

Para acceder a informes de uso y costo de tu organización, utiliza los puntos finales de la API de uso y costo:

El punto final de uso (/v1/organizations/usage_report/messages) proporciona datos de uso detallados, incluyendo conteos de tokens y métricas de solicitudes, agrupados por varias dimensiones como espacio de trabajo, usuario y modelo.
El punto final de costo (/v1/organizations/cost_report) proporciona datos de costo asociados con el uso de tu organización, permitiéndote rastrear gastos y asignar costos por espacio de trabajo o descripción.

Estos puntos finales proporcionan información detallada sobre el uso de tu organización y los costos asociados.

Acceso a análisis de Claude Code

Para organizaciones que utilizan Claude Code, la API de análisis de Claude Code proporciona métricas de productividad detalladas e información de uso:

El punto final de análisis de Claude Code (/v1/organizations/usage_report/claude_code) proporciona métricas agregadas diarias para el uso de Claude Code, incluyendo sesiones, líneas de código, confirmaciones, solicitudes de extracción, estadísticas de uso de herramientas y datos de costo desglosados por usuario y modelo.

Esta API te permite rastrear la productividad de los desarrolladores, analizar la adopción de Claude Code y crear paneles personalizados para tu organización.

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 de errores adecuado para operaciones fallidas
Audita regularmente los roles y permisos de los miembros
Limpia espacios de trabajo no utilizados e invitaciones expiradas
Monitorea el uso de claves API y rota las claves periódicamente

Cómo funciona la API de administración

Roles y permisos de la organización

Conceptos clave

Miembros de la organización

Invitaciones de la organización

Espacios de trabajo

Miembros del espacio de trabajo

Claves API

Acceso a la información de la organización

Acceso a informes de uso y costo

Acceso a análisis de Claude Code

Mejores prácticas

Preguntas frecuentes

¿Qué permisos se necesitan para usar la API de administración?

¿Puedo crear nuevas claves API a través de la API de administración?

¿Qué sucede con las claves API al eliminar un usuario?

¿Se pueden eliminar administradores de la organización a través de la API?

¿Cuánto tiempo duran las invitaciones de la organización?

¿Hay límites en los espacios de trabajo?

¿Qué es el espacio de trabajo predeterminado?

¿Cómo afectan los roles de la organización al acceso del espacio de trabajo?

¿Qué roles se pueden asignar en espacios de trabajo?

¿Se pueden cambiar los roles de espacio de trabajo de los administradores o miembros de facturación de la organización?

¿Qué sucede con el acceso al espacio de trabajo cuando cambian los roles de la organización?

Cómo funciona la API de administración

Roles y permisos de la organización

Conceptos clave

Miembros de la organización

Invitaciones de la organización

Espacios de trabajo

Miembros del espacio de trabajo

Claves API

Acceso a la información de la organización

Acceso a informes de uso y costo

Acceso a análisis de Claude Code

Mejores prácticas

Preguntas frecuentes

¿Qué permisos se necesitan para usar la API de administración?

¿Puedo crear nuevas claves API a través de la API de administración?

¿Qué sucede con las claves API al eliminar un usuario?

¿Se pueden eliminar administradores de la organización a través de la API?

¿Cuánto tiempo duran las invitaciones de la organización?

¿Hay límites en los espacios de trabajo?

¿Qué es el espacio de trabajo predeterminado?

¿Cómo afectan los roles de la organización al acceso del espacio de trabajo?

¿Qué roles se pueden asignar en espacios de trabajo?

¿Se pueden cambiar los roles de espacio de trabajo de los administradores o miembros de facturación de la organización?

¿Qué sucede con el acceso al espacio de trabajo cuando cambian los roles de la organización?