AdministraciónOrganización

Admin API

La Admin API no está disponible para cuentas individuales. Para colaborar con compañeros de equipo y agregar miembros, configura tu organización en Console → Settings → Organization.

La Admin API te permite gestionar programáticamente los recursos de tu organización, incluyendo miembros de la organización, espacios de trabajo y claves de API. Esto proporciona control programático sobre tareas administrativas que de otro modo requerirían configuración manual en la Claude Console.

La Admin API requiere acceso especial

La Admin API acepta dos credenciales: una clave de Admin API (que comienza con sk-ant-admin...) enviada en el encabezado x-api-key o un token bearer de OAuth con el alcance org:admin enviado en el encabezado authorization: Bearer. Solo los miembros de la organización con el rol de admin pueden aprovisionar claves de Admin API, y solo los miembros con el rol de admin, owner o primary owner pueden obtener tokens org:admin. Consulta Crear una clave de Admin API.

Claude Platform en AWS: La mayor parte de la Admin API no está disponible en Claude Platform en AWS. Los endpoints de espacios de trabajo (crear, obtener, listar, actualizar y archivar en /v1/organizations/workspaces) están disponibles. Otros endpoints, incluyendo miembros de la organización, miembros de espacios de trabajo, invitaciones, claves de API, informes de uso, informes de costos e informes de límite de velocidad, no están disponibles. Consulta Claude Platform en AWS para más detalles.

Autenticación

Autentícate con cualquiera de las dos credenciales. Para crear una clave de Admin API para tu tipo de organización, consulta Crear una clave de Admin API. Los siguientes ejemplos llaman al endpoint de información de la organización de ambas formas:

Bearer de OAuth:

cURL

curl --fail-with-body -sS "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"

Un token org:admin otorga acceso a toda la organización, independientemente del espacio de trabajo al que esté vinculado el perfil o la regla de federación subyacente. Para obtener uno, consulta los requisitos previos en Gestionar WIF con la Admin API.

Clave de Admin API:

cURL

curl --fail-with-body -sS "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Cómo funciona la Admin API

Cuando usas la Admin API:

Realizas solicitudes usando cualquiera de las credenciales de la sección de Autenticación
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 de API
- Cuentas de servicio, emisores de federación y reglas de federación (estos endpoints requieren un token OAuth org:admin; las claves de Admin API no se aceptan)

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 de API

Roles y permisos de la organización

Existen cinco roles a nivel de organización. Consulta más detalles en el artículo Roles y permisos de la API Console.

Rol	Permisos
user	Puede usar Workbench
claude_code_user	Puede usar Workbench y Claude Code
developer	Puede usar Workbench y gestionar claves de API
billing	Puede usar Workbench y gestionar detalles de facturación
admin	Puede hacer todo lo anterior, además de gestionar usuarios

Los owners y primary owners de la organización tienen todos los permisos de admin y además pueden gestionar admins. Todas las referencias al rol de admin en esta página también aplican a owners y primary owners.

Conceptos clave

Miembros de la organización

Puedes listar miembros de la organización, actualizar roles de miembros y eliminar miembros.

cURL

# 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 "content-type: application/json" \
  --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.

cURL

# Crear invitación
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "email": "[email protected]",
    "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

Para una guía completa sobre espacios de trabajo, incluyendo ejemplos de Console y API, consulta Espacios de trabajo.

Miembros de espacios de trabajo

Gestiona el acceso de usuarios a espacios de trabajo específicos:

cURL

# Agregar miembro al workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Listar miembros del workspace
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 del miembro
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "workspace_role": "workspace_admin"
  }'

# Eliminar miembro del 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 de API

Monitorea y gestiona claves de API:

cURL

# Listar claves de 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 de API
curl --request POST "https://api.anthropic.com/v1/organizations/api_keys/{api_key_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

Cuentas de servicio

Crea y gestiona cuentas de servicio (svac_...), las identidades no humanas como las que actúan los tokens de Workload Identity Federation. Las claves de Admin API no se aceptan en los endpoints de cuentas de servicio, emisores de federación o reglas de federación; usa un token OAuth org:admin. Consulta Gestionar WIF con la Admin API.

Emisores de federación

Registra los proveedores de identidad OIDC (fdis_...) cuyos tokens pueden afirmar la identidad de carga de trabajo para tu organización. Consulta Gestionar WIF con la Admin API.

Reglas de federación

Gestiona las reglas (fdrl_...) que asignan tokens de emisores a cuentas de servicio y alcances. Consulta Gestionar WIF con la Admin API.

Acceso a la información de la organización

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

Por ejemplo:

cURL

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

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

Este endpoint es útil para determinar programáticamente a qué organización pertenece una clave de Admin API.

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

Informes de uso y costos

Rastrea el uso y los costos de tu organización con la API de uso y costos.

Analíticas de Claude Code

Monitorea la productividad de los desarrolladores y la adopción de Claude Code con la API de analíticas de Claude Code.

Límites de velocidad

Lee los límites de velocidad configurados para tu organización y sus espacios de trabajo con la API de límites de velocidad.

API de cumplimiento

Recupera datos de auditoría y actividad de tu organización con la API de cumplimiento. Las claves de Admin API solo pueden leer el Activity Feed; para acceso completo, consulta Configurar la API de cumplimiento.

Mejores prácticas

Para usar la Admin API de manera efectiva:

Usa nombres y descripciones significativos para espacios de trabajo y claves de API
Implementa un manejo adecuado de errores para operaciones fallidas
Audita regularmente los roles y permisos de los miembros
Limpia los espacios de trabajo sin usar y las invitaciones expiradas
Monitorea el uso de claves de API y rota las claves periódicamente

Preguntas frecuentes

Para preguntas específicas sobre espacios de trabajo, consulta las Preguntas frecuentes sobre espacios de trabajo.

Was this page helpful?

AdministraciónOrganización

Admin API

La Admin API no está disponible para cuentas individuales. Para colaborar con compañeros de equipo y agregar miembros, configura tu organización en Console → Settings → Organization.

La Admin API requiere acceso especial

Autenticación

Bearer de OAuth:

cURL

curl --fail-with-body -sS "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "authorization: Bearer $ANTHROPIC_OAUTH_TOKEN"

Clave de Admin API:

cURL

curl --fail-with-body -sS "https://api.anthropic.com/v1/organizations/me" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Cómo funciona la Admin API

Cuando usas la Admin API:

Realizas solicitudes usando cualquiera de las credenciales de la sección de Autenticación
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 de API
- Cuentas de servicio, emisores de federación y reglas de federación (estos endpoints requieren un token OAuth org:admin; las claves de Admin API no se aceptan)

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 de API

Roles y permisos de la organización

Existen cinco roles a nivel de organización. Consulta más detalles en el artículo Roles y permisos de la API Console.

Rol	Permisos
user	Puede usar Workbench
claude_code_user	Puede usar Workbench y Claude Code
developer	Puede usar Workbench y gestionar claves de 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.

cURL

# 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 "content-type: application/json" \
  --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.

cURL

# Crear invitación
curl --request POST "https://api.anthropic.com/v1/organizations/invites" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "email": "[email protected]",
    "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

Para una guía completa sobre espacios de trabajo, incluyendo ejemplos de Console y API, consulta Espacios de trabajo.

Miembros de espacios de trabajo

Gestiona el acceso de usuarios a espacios de trabajo específicos:

cURL

# Agregar miembro al workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Listar miembros del workspace
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 del miembro
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "workspace_role": "workspace_admin"
  }'

# Eliminar miembro del 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 de API

Monitorea y gestiona claves de API:

cURL

# Listar claves de 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 de API
curl --request POST "https://api.anthropic.com/v1/organizations/api_keys/{api_key_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "status": "inactive",
    "name": "New Key Name"
  }'

Cuentas de servicio

Emisores de federación

Registra los proveedores de identidad OIDC (fdis_...) cuyos tokens pueden afirmar la identidad de carga de trabajo para tu organización. Consulta Gestionar WIF con la Admin API.

Reglas de federación

Gestiona las reglas (fdrl_...) que asignan tokens de emisores a cuentas de servicio y alcances. Consulta Gestionar WIF con la Admin API.

Acceso a la información de la organización

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

Por ejemplo:

cURL

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

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

Este endpoint es útil para determinar programáticamente a qué organización pertenece una clave de Admin API.

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

Informes de uso y costos

Rastrea el uso y los costos de tu organización con la API de uso y costos.

Analíticas de Claude Code

Monitorea la productividad de los desarrolladores y la adopción de Claude Code con la API de analíticas de Claude Code.

Límites de velocidad

Lee los límites de velocidad configurados para tu organización y sus espacios de trabajo con la API de límites de velocidad.

API de cumplimiento

Mejores prácticas

Para usar la Admin API de manera efectiva:

Usa nombres y descripciones significativos para espacios de trabajo y claves de API
Implementa un manejo adecuado de errores para operaciones fallidas
Audita regularmente los roles y permisos de los miembros
Limpia los espacios de trabajo sin usar y las invitaciones expiradas
Monitorea el uso de claves de API y rota las claves periódicamente

Preguntas frecuentes

Para preguntas específicas sobre espacios de trabajo, consulta las Preguntas frecuentes sobre espacios de trabajo.

Was this page helpful?

Autenticación

Cómo funciona la Admin API

Roles y permisos de la organización

Conceptos clave

Miembros de la organización

Invitaciones de la organización

Espacios de trabajo

Miembros de espacios de trabajo

Claves de API

Cuentas de servicio

Emisores de federación

Reglas de federación

Acceso a la información de la organización

Informes de uso y costos

Analíticas de Claude Code

Límites de velocidad

API de cumplimiento

Mejores prácticas

Preguntas frecuentes

¿Qué permisos se necesitan para usar la Admin API?

¿Puedo crear nuevas claves de API a través de la Admin API?

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

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

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

Autenticación

Cómo funciona la Admin API

Roles y permisos de la organización

Conceptos clave

Miembros de la organización

Invitaciones de la organización

Espacios de trabajo

Miembros de espacios de trabajo

Claves de API

Cuentas de servicio

Emisores de federación

Reglas de federación

Acceso a la información de la organización

Informes de uso y costos

Analíticas de Claude Code

Límites de velocidad

API de cumplimiento

Mejores prácticas

Preguntas frecuentes

¿Qué permisos se necesitan para usar la Admin API?

¿Puedo crear nuevas claves de API a través de la Admin API?

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

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

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

Autenticación

Cómo funciona la Admin API

Roles y permisos de la organización

Conceptos clave

Miembros de la organización

Invitaciones de la organización

Espacios de trabajo

Miembros de espacios de trabajo

Claves de API

Cuentas de servicio

Emisores de federación

Reglas de federación

Acceso a la información de la organización

Informes de uso y costos

Analíticas de Claude Code

Límites de velocidad

API de cumplimiento

Mejores prácticas

Preguntas frecuentes

Autenticación

Cómo funciona la Admin API

Roles y permisos de la organización

Conceptos clave

Miembros de la organización

Invitaciones de la organización

Espacios de trabajo

Miembros de espacios de trabajo

Claves de API

Cuentas de servicio

Emisores de federación

Reglas de federación

Acceso a la información de la organización

Informes de uso y costos

Analíticas de Claude Code

Límites de velocidad

API de cumplimiento

Mejores prácticas

Preguntas frecuentes