Gestión de usuarios
Gestiona a las personas de tu organización de Claude Enterprise con la Admin API: enumera miembros y cambia roles, envía y retira invitaciones, gestiona grupos y lee roles personalizados.
Esta página explica cómo administrar de forma programática a las personas de tu organización de Claude Enterprise (claude.ai) mediante la Admin API:
- Listar miembros y buscarlos por dirección de correo electrónico
- Cambiar el rol de un miembro
- Eliminar miembros, o cerrar su sesión en todas partes sin eliminarlos (beta)
- Enviar y retirar invitaciones
- Administrar los grupos de tu empresa y su membresía
- Leer los roles personalizados de tu organización
Para organizaciones de Claude Console (Claude Platform), consulta la guía de la Admin API para Claude Console.
¿Qué endpoints puede usar tu organización?
La Admin API es un único conjunto de endpoints bajo https://api.anthropic.com/v1/organizations/. Las organizaciones de Claude Console y de Claude Enterprise se autentican con diferentes claves de Admin API y cada una tiene acceso a un subconjunto diferente de los endpoints:
| Endpoints | Claude Console (Claude Platform) | Claude Enterprise (claude.ai) |
|---|---|---|
| Miembros e invitaciones | Disponible; consulta la guía de la Admin API | Disponible (esta página) |
| Grupos | No disponible | Disponible (esta página) |
| Roles personalizados | No disponible | Disponible, solo lectura (esta página) |
| Plugins y Claude Tag | No disponible | Disponible en beta |
| Límites de gasto | No disponible | Disponible |
| Informes de uso y costos | Disponible; consulta la API de análisis de uso y costos | Disponible a través de la API de análisis de uso y costos y la Claude Enterprise Analytics API |
| Espacios de trabajo, claves de API, límites de velocidad y los demás endpoints de la guía de la Admin API | Disponible | No disponible |
Los miembros y las invitaciones usan los mismos endpoints para ambos tipos de organización; esta página documenta su comportamiento en Claude Enterprise, incluidos los roles de organización de Claude Enterprise. Los endpoints de grupos y roles personalizados existen solo para Claude Enterprise.
Descripción general
Esta página cubre cinco recursos:
| Recurso | Endpoints | Uso |
|---|---|---|
| Miembros | GET /v1/organizations/usersGET /v1/organizations/users/{user_id}POST /v1/organizations/users/{user_id}DELETE /v1/organizations/users/{user_id}POST /v1/organizations/users/{user_id}/sign_out (beta) | Enumerar los miembros de la organización o buscar uno por correo electrónico; cambiar el rol de un miembro; eliminar un miembro; cerrar la sesión de un miembro en todas partes. |
| Invitaciones | POST /v1/organizations/invitesGET /v1/organizations/invitesGET /v1/organizations/invites/{invite_id}DELETE /v1/organizations/invites/{invite_id} | Invitar a una persona a la organización, hacer seguimiento del estado de la invitación y retirarla antes de que se acepte. |
| Grupos | GET /v1/organizations/rbac_groupsGET /v1/organizations/rbac_groups/{rbac_group_id}POST /v1/organizations/rbac_groupsPOST /v1/organizations/rbac_groups/{rbac_group_id}DELETE /v1/organizations/rbac_groups/{rbac_group_id} | Leer los grupos de tu empresa y los roles personalizados asociados a cada uno; crear, renombrar y eliminar grupos. |
| Miembros de grupos | GET /v1/organizations/rbac_groups/{rbac_group_id}/membersPOST /v1/organizations/rbac_groups/{rbac_group_id}/membersDELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id} | Leer los miembros de un grupo; agregar y eliminar miembros. |
| Roles personalizados | GET /v1/organizations/rbac_rolesGET /v1/organizations/rbac_roles/{rbac_role_id}GET /v1/organizations/rbac_roles/{rbac_role_id}/permissions | Leer los roles personalizados de tu organización y los permisos que otorga cada rol. |
Los roles personalizados y sus asociaciones a grupos se gestionan en la configuración de la organización de claude.ai; la API los lee pero no puede cambiarlos.
Inicio rápido
Establece la variable de entorno ANTHROPIC_API_KEY con tu clave de Admin API. Los ejemplos de esta página leen la clave desde ella. El SDK y la CLI ant envían los encabezados Authorization y anthropic-version por ti.
Enumera los miembros de la organización, del más reciente al más antiguo:
client = anthropic.Anthropic()
users = client.organization.users.list(limit=20)
for user in users:
print(f"{user.id}: {user.email} ({user.role})"){
"data": [
{
"type": "user",
"id": "user_01AbCdEfGhIjKlMnOpQrSt",
"email": "jane@example.com",
"name": "Jane Smith",
"role": "user",
"added_at": "2026-06-12T09:14:03Z"
}
],
"has_more": false,
"first_id": "user_01AbCdEfGhIjKlMnOpQrSt",
"last_id": "user_01AbCdEfGhIjKlMnOpQrSt"
}Conceptos clave
Roles de organización
Cada miembro tiene exactamente un rol de organización. Las lecturas devuelven el rol del miembro como uno de cinco valores:
| Rol | Significado |
|---|---|
user | Un miembro estándar. |
managed | Un miembro cuyos permisos se otorgan a través de los roles personalizados asociados a sus grupos. |
owner | Un propietario de la organización. |
membership_admin | Un miembro que puede gestionar los miembros de la organización. |
primary_owner | El propietario principal de la organización. Hay exactamente uno. |
La API solo puede asignar los roles user y managed, al crear invitaciones y al actualizar roles. Asignar managed requiere el alcance write:rbac_groups además de write:members, porque los permisos de un miembro gestionado provienen de los roles personalizados asociados a sus grupos. Los roles administrativos (owner, membership_admin y primary_owner) se asignan en la configuración de la organización de claude.ai, y los miembros que los tienen no pueden modificarse ni eliminarse a través de esta API.
Miembros e invitaciones
Una persona se convierte en miembro al aceptar una invitación (o mediante el inicio de sesión único de tu organización, donde esté configurado). Crear una invitación envía un correo electrónico de invitación; la invitación se lee entonces como pending hasta que el destinatario la acepta (accepted) o pasa su expires_at asignado por el servidor (expired). Solo se puede retirar una invitación pending. Para cambiar la dirección de correo electrónico o el rol de una invitación pendiente, retírala y crea una nueva.
Si el plan de tu organización asigna miembros desde un grupo finito de asientos comprados, una invitación pendiente consume un asiento. El endpoint de creación de invitaciones no acepta un parámetro de asiento ni de nivel: el asiento se asigna automáticamente desde el nivel más bajo que tenga disponibilidad. Crear una invitación cuando no hay ningún asiento libre falla con un error 400 en lugar de comprar un asiento. Retirar la invitación, dejar que expire o eliminar al miembro más adelante devuelve el asiento al grupo.
Grupos y roles
Los grupos conectan a los miembros con roles personalizados (“role-based access control” (control de acceso basado en roles), el rbac de las rutas de los endpoints y de los nombres de los alcances). Los grupos pertenecen a tu organización principal y a todas las organizaciones que dependen de ella, no a una sola organización. Por eso, los alcances de grupos (read:rbac_groups y write:rbac_groups) requieren una clave creada para todas las organizaciones vinculadas. Cada grupo tiene un source_type: direct para los grupos creados en claude.ai, scim para los grupos aprovisionados por tu proveedor de identidad. El campo role_ids de un grupo lista los ID de los roles personalizados asociados a él. Resuélvelos a nombres y permisos con los endpoints de roles personalizados. Cada organización tiene su propio catálogo de roles, pero los grupos se comparten en toda tu organización principal. Por eso, obtener un rol que pertenece a otra organización de tu organización principal devuelve 404 para tu clave. El campo role_ids es null (en lugar de []) cuando los datos de roles no estaban disponibles temporalmente, así que vuelve a intentarlo para distinguir una lectura degradada de un grupo sin roles.
Control de versiones
Envía el encabezado anthropic-version en cada solicitud; consulta Versiones de la API para ver las versiones disponibles.
Límites de velocidad
Los endpoints de la Admin API comparten un límite por organización de 100 solicitudes por minuto; la creación de invitaciones tiene en cambio su propio límite de 1,200 solicitudes por hora. Las solicitudes que superan un límite devuelven 429 Too Many Requests.
Paginación
Las listas de miembros e invitaciones usan paginación basada en ID: pasa limit (valor predeterminado 20, máximo 1,000) más, como máximo, uno de before_id o after_id, y pagina usando los campos first_id y last_id de cada respuesta hasta que has_more sea false. Las listas de grupos y de roles personalizados usan en cambio un cursor opaco: pasa el valor next_page de la respuesta sin modificar como parámetro page en la siguiente solicitud, hasta que next_page sea null.
Cuando iteras sobre los resultados, el SDK obtiene más páginas por ti, por lo que limit establece el tamaño de página, no el total. En la CLI, --limit establece el número total de resultados para las listas de miembros e invitaciones. Para las listas de grupos y roles, establece el tamaño de página.
Respuestas de error
Las respuestas de error siguen la estructura estándar documentada en Errores de la API de Claude.
Miembros
Enumerar miembros
GET /v1/organizations/users devuelve los miembros de la organización, empezando por los agregados más recientemente. Filtra por email para buscar un miembro específico; la coincidencia no distingue mayúsculas de minúsculas y tolera variantes comunes de la misma dirección (por ejemplo, jane+hiring@example.com coincide con jane@example.com). Requiere el alcance read:members.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Listar usuariosVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
users = client.organization.users.list(email="jane@example.com")
for user in users:
print(f"{user.id}: {user.email} ({user.role})")Obtener un miembro
GET /v1/organizations/users/{user_id} devuelve un miembro por ID. Requiere el alcance read:members.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Obtener usuarioVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
user = client.organization.users.retrieve("user_01AbCdEfGhIjKlMnOpQrSt")
print(f"id: {user.id}")
print(f"email: {user.email}")
print(f"role: {user.role}")Cambiar el rol de un miembro
POST /v1/organizations/users/{user_id} establece el rol del miembro en user o managed. Los miembros que tienen un rol administrativo (owner, membership_admin o primary_owner) no pueden cambiarse a través de este endpoint, y los roles administrativos no pueden asignarse; ambos casos devuelven 400 y se gestionan en la configuración de la organización de claude.ai. Si el proveedor de identidad de tu organización gestiona los roles (SSO avanzado o aprovisionamiento SCIM avanzado), las actualizaciones de roles devuelven 400. Requiere el alcance write:members, más write:rbac_groups al cambiar el rol a managed.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Actualizar usuarioVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
user = client.organization.users.update("user_01AbCdEfGhIjKlMnOpQrSt", role="managed")
print(f"id: {user.id}")
print(f"role: {user.role}")Eliminar un miembro
DELETE /v1/organizations/users/{user_id} elimina al miembro de la organización y devuelve al grupo de la organización cualquier asiento comprado que ocupara. Los miembros que tienen un rol administrativo no pueden eliminarse a través de este endpoint, y si tu proveedor de identidad gestiona la membresía (SCIM), las eliminaciones devuelven 400. Requiere el alcance write:members.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Quitar usuarioVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
removed_user = client.organization.users.remove("user_01AbCdEfGhIjKlMnOpQrSt")
print(f"id: {removed_user.id}"){
"type": "user_deleted",
"id": "user_01AbCdEfGhIjKlMnOpQrSt"
}Cerrar la sesión de un miembro en todas partes
POST /v1/organizations/users/{user_id}/sign_out cierra la sesión de un miembro en Claude en todos los navegadores y dispositivos, sin eliminarlo de la organización. Úsalo cuando el dispositivo de un miembro se pierda o sea robado, durante un incidente de seguridad, o mientras investigas una cuenta antes de decidir si eliminar al miembro. Requiere el alcance write:members.
El cierre de sesión alcanza toda la cuenta de Claude de la persona, incluidas sus sesiones en otras organizaciones y en un plan individual. El miembro conserva su puesto y su rol y puede volver a iniciar sesión de inmediato. Para mantener a alguien fuera, elimínalo o, si tu organización requiere inicio de sesión único, desactiva su cuenta en tu proveedor de identidad. Desactivarla impide nuevos inicios de sesión, pero lo deja en tu lista de miembros. Si eliminas a alguien y dejas activa su cuenta del proveedor de identidad, el aprovisionamiento automático puede volver a agregarlo en su próximo inicio de sesión. Si tu proveedor de identidad administra la membresía, solo puedes eliminar al miembro allí.
Crea la clave antes de necesitarla. Consulta Crear una clave para una organización de Claude Enterprise. Una clave write:members solo funciona en la organización en la que se creó, por lo que cada organización vinculada necesita su propia clave. El propietario principal de esa organización la crea. Para buscar miembros por dirección de correo electrónico con la misma clave, selecciona también el alcance read:members.
La solicitud no tiene cuerpo. Pasa el id del miembro, que devuelve Enumerar miembros:
client = anthropic.Anthropic()
user = client.beta.organization.users.sign_out("user_01AbCdEfGhIjKlMnOpQrSt")
print(f"id: {user.id}")Una solicitud exitosa devuelve 200 con el miembro, cuyo rol y demás campos no cambian:
{
"type": "user",
"id": "user_01AbCdEfGhIjKlMnOpQrSt",
"email": "jane@example.com",
"name": "Jane Smith",
"role": "user",
"added_at": "2026-06-12T09:14:03Z"
}Si aún no tienes una clave, un propietario puede usar en su lugar la acción Cerrar sesión en todos lados en la página Miembros de la configuración de la organización de claude.ai. Finaliza las mismas sesiones, dispositivos de confianza y tokens de OAuth, y elimina los mismos registros de notificaciones push. Un propietario no puede usarla en su propia cuenta: cierra sus propias sesiones desde la configuración de su cuenta en claude.ai.
Qué finaliza la solicitud
La solicitud finaliza todo lo siguiente para el miembro:
- Sesiones iniciadas: Todas las de la cuenta de la persona, en todos los navegadores y dispositivos.
- Dispositivos de confianza: Cada navegador, computadora o teléfono que la persona registró como de confianza para acciones sensibles. La persona debe volver a registrar cada dispositivo.
- Tokens de OAuth emitidos para esta organización: Sin importar qué aplicación los tenga, como Claude Code o una aplicación de terceros. Esas aplicaciones deben volver a iniciar sesión. Un token casi siempre deja de funcionar de inmediato, y como máximo en una hora.
La solicitud también borra el registro de los navegadores en los que la persona eligió omitir la verificación en dos pasos de Claude, de modo que el próximo inicio de sesión allí vuelva a pedir el segundo paso. También elimina los registros de notificaciones push que Claude tiene para los teléfonos, aplicaciones de escritorio y navegadores de la persona, de modo que Claude deje de enviarles notificaciones. Esta eliminación se ejecuta de forma asíncrona: normalmente se completa en un minuto, pero en casos excepcionales puede tardar más. Un 200 no confirma ninguno de estos dos pasos.
Solo los tokens de OAuth se limitan a esta organización. Las sesiones, los dispositivos de confianza y los registros de notificaciones push pertenecen a la cuenta de la persona, por lo que el cierre de sesión también alcanza sus otras organizaciones y cualquier plan individual.
La solicitud no elimina nada que ya esté almacenado en un dispositivo.
Qué no finaliza la solicitud
La solicitud no finaliza nada de lo siguiente:
- Claves de API: Siguen funcionando, incluidas las claves de Admin API que creó la persona. Para detener una clave de Admin API, elimínala en la sección Claves de claude.ai > Configuración de la organización > API.
- Tokens de OAuth para otras organizaciones: Para finalizarlos, envía la solicitud en cada organización con la clave de esa organización. La persona tiene el mismo
iden todas las organizaciones. Los tokens de OAuth emitidos para la cuenta de la persona y no para una organización también siguen funcionando, y esta solicitud no puede finalizarlos. - Sesiones en la nube y rutinas de Claude Code: Las sesiones que se ejecutan en la infraestructura de Anthropic, como Claude Code en la web, o en uno de tus entornos autoalojados siguen ejecutándose. El trabajo en curso cuando envías la solicitud, o iniciado poco después, puede fallar. La sesión obtiene entonces nuevas credenciales sin que la persona vuelva a iniciar sesión, y continúa. Las rutinas de la persona que se ejecutan según una programación o con eventos de GitHub siguen iniciando nuevas sesiones. La acción Cerrar sesión en todos lados también las deja en ejecución.
- Computadoras vinculadas a Cowork: Permanecen vinculadas.
- Un inicio de sesión en curso: Uno que ya esté en marcha puede completarse durante la solicitud, o hasta 5 minutos después. Si la exportación del registro de auditoría o el Activity Feed muestra que la persona inició sesión después de la solicitud, envíala de nuevo. Los inicios de sesión en aplicaciones como Claude Code no se registran allí, así que si la persona estaba iniciando sesión en una, envíala de nuevo después de 5 minutos.
A quién no puedes cerrarle la sesión
La solicitud no puede cerrar la sesión del propietario principal de la organización: devuelve 400 con el código de error cannot_sign_out_primary_owner. Nadie en tu organización puede cerrar la sesión del propietario principal, tampoco en la página Miembros. El propietario principal cierra sus propias sesiones desde la configuración de su cuenta en claude.ai.
Una clave con el alcance write:members puede cerrar la sesión de todos los demás. Eso incluye a los propietarios, a los miembros cuyos roles personalizados incluyen el permiso para administrar propietarios y a los miembros con el rol membership_admin. Los propietarios y el propietario principal pueden hacer lo mismo con la acción Cerrar sesión en todos lados en la página Miembros. Solo cuenta el rol del miembro en esta organización, por lo que puedes cerrar la sesión de alguien que sea el propietario principal de otra organización.
La clave sigue funcionando después de que la persona que la creó cambie de rol o abandone la organización. Consulta ¿Qué sucede con una clave de Admin API cuando la persona que la creó se va?.
Respuestas
| Estado | Significado |
|---|---|
| 200 | El cierre de sesión se completó. Es seguro reintentar: una solicitud que no encuentra nada que finalizar también devuelve 200, y una segunda solicitud finaliza cualquier sesión, dispositivo de confianza o token de OAuth que la persona haya obtenido desde la primera. |
400 cannot_sign_out_primary_owner | El miembro es el propietario principal, cuya sesión no se puede cerrar. Consulta A quién no puedes cerrarle la sesión. |
400 organization_not_enrolled_in_beta | El endpoint no está disponible para tu organización. |
| 400 | La solicitud omite el valor anthropic-beta, que el mensaje indica, o el id en la ruta no comienza con user_. |
| 401 | La clave falta, no es válida o fue eliminada, o se creó para una organización principal y no está vinculada a una sola organización. |
| 403 | La clave no tiene el alcance write:members. |
| 404 | No hay ningún miembro con ese ID en tu organización. |
| 429 | La organización supera el límite de velocidad que comparten los endpoints de Admin API. El encabezado retry-after indica cuándo reintentar. El cierre de sesión no tiene un límite independiente. |
| 503 | Un servicio que necesita la solicitud no está disponible temporalmente. Lo que la solicitud ya finalizó permanece finalizado. Envía la solicitud de nuevo para finalizar el resto. |
Las respuestas de error siguen la estructura estándar documentada en Errores de la API de Claude, con el código de error en error.details.error_code:
{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "...",
"details": {
"error_code": "cannot_sign_out_primary_owner"
}
},
"request_id": "req_018EeWyXxfu5pfWkrYcMdjWG"
}Dónde se registra el cierre de sesión
Cada cierre de sesión completado se registra como org_user_trusted_devices_revoked, el mismo evento que registra la acción Cerrar sesión en todos lados. Aparece en la exportación del registro de auditoría que los propietarios descargan en claude.ai. Si tu organización tiene la Compliance API, también aparece en el Activity Feed, con el recuento de los dispositivos de confianza y las sesiones que finalizó la solicitud. Una solicitud que se detiene a mitad de camino también aparece en el Activity Feed, con completed establecido en false, y no en el registro de auditoría.
Invitaciones
Crear una invitación
POST /v1/organizations/invites envía un correo electrónico de invitación y devuelve la invitación con un expires_at asignado por el servidor. role debe ser user o managed. Si ya existe una invitación pendiente para la dirección de correo electrónico, o la dirección ya pertenece a un miembro, la solicitud devuelve 400 indicando el recurso existente. Las organizaciones cuyo proveedor de identidad aprovisiona usuarios automáticamente (JIT o SCIM) no pueden crear invitaciones a través de la API. Requiere el alcance write:members, más write:rbac_groups cuando role es managed.
En los planes que asignan miembros desde un grupo finito de asientos, la invitación toma automáticamente un asiento del nivel más bajo que tenga disponibilidad. La API no acepta un parámetro de nivel. Si no hay ningún asiento libre, la solicitud falla con un error 400 en lugar de comprar un asiento. Agrega asientos a través de la gestión del plan de la organización y vuelve a intentarlo.
El campo opcional rbac_group_ids enumera los grupos (por ID con prefijo rbac_group_) que se asignarán al miembro cuando acepte. Pasar un rbac_group_ids no vacío requiere además que la clave tenga el alcance write:rbac_groups, porque la asignación de grupos puede otorgar los permisos asociados a los roles del grupo.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Crear invitaciónVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
invite = client.organization.invites.create(
email="newhire@example.com",
role="managed",
rbac_group_ids=["rbac_group_01UvWxYzAbCdEfGhIjKlMn"],
)
print(f"id: {invite.id}")
print(f"email: {invite.email}")
print(f"status: {invite.status}")
print(f"expires_at: {invite.expires_at}"){
"type": "invite",
"id": "invite_01QrStUvWxYzAbCdEfGhIj",
"email": "newhire@example.com",
"role": "managed",
"invited_at": "2026-07-06T16:20:11Z",
"expires_at": "2026-07-27T16:20:11Z",
"accepted_at": null,
"status": "pending",
"rbac_group_ids": ["rbac_group_01UvWxYzAbCdEfGhIjKlMn"]
}Enumerar invitaciones
GET /v1/organizations/invites devuelve las invitaciones de la organización, empezando por las más recientes, en los estados pending, accepted y expired. Para enumerar solo las invitaciones en ciertos estados, pasa statuses[] una vez por cada estado, por ejemplo statuses[]=pending. Requiere el alcance read:members.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Listar invitacionesVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
invites = client.organization.invites.list(limit=20)
for invite in invites:
print(f"{invite.id}: {invite.email} ({invite.status})")Obtener una invitación
GET /v1/organizations/invites/{invite_id} devuelve una invitación por ID. Requiere el alcance read:members.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Obtener invitaciónVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
invite = client.organization.invites.retrieve("invite_01QrStUvWxYzAbCdEfGhIj")
print(f"id: {invite.id}")
print(f"email: {invite.email}")
print(f"status: {invite.status}")Retirar una invitación
DELETE /v1/organizations/invites/{invite_id} retira una invitación pending y desactiva el enlace del correo electrónico de invitación. Retirar una invitación accepted devuelve 400 (elimina al miembro en su lugar); retirar una invitación expired devuelve 400. Requiere el alcance write:members.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Eliminar invitaciónVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
deleted_invite = client.organization.invites.delete("invite_01QrStUvWxYzAbCdEfGhIj")
print(f"id: {deleted_invite.id}")Grupos
Los grupos que tu empresa crea directamente, en la configuración de la organización de claude.ai o a través de esta API (source_type: "direct"), admiten todos los endpoints de esta sección. Los grupos aprovisionados por tu proveedor de identidad (source_type: "scim") pueden leerse pero no modificarse: renombrar o eliminar un grupo SCIM, o cambiar su membresía, devuelve 400, porque tu proveedor de identidad es su propietario.
Enumerar grupos
GET /v1/organizations/rbac_groups devuelve los grupos de tu empresa, incluidos los grupos gestionados por el proveedor de identidad (scim). Requiere el alcance read:rbac_groups.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Listar gruposVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
groups = client.beta.organization.rbac_groups.list(limit=20)
for group in groups:
print(f"{group.id}: {group.name} ({group.source_type})"){
"data": [
{
"type": "rbac_group",
"id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"name": "Engineering",
"source_type": "direct",
"role_ids": ["rbac_role_01CdEfGhIjKlMnOpQrStUv"],
"created_at": "2026-03-18T10:01:42Z",
"updated_at": "2026-05-02T08:55:09Z"
}
],
"has_more": false,
"next_page": null
}Obtener un grupo
GET /v1/organizations/rbac_groups/{rbac_group_id} devuelve un grupo por ID. Requiere el alcance read:rbac_groups.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Obtener grupoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
group = client.beta.organization.rbac_groups.retrieve(
"rbac_group_01UvWxYzAbCdEfGhIjKlMn"
)
print(f"id: {group.id}")
print(f"name: {group.name}")
print(f"source_type: {group.source_type}")Crear un grupo
POST /v1/organizations/rbac_groups crea un grupo con el name indicado (de 1 a 255 caracteres) y sin roles ni miembros. Requiere el alcance write:rbac_groups.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Crear grupoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
group = client.beta.organization.rbac_groups.create(name="Engineering")
print(f"id: {group.id}")
print(f"name: {group.name}"){
"type": "rbac_group",
"id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"name": "Engineering",
"source_type": "direct",
"role_ids": [],
"created_at": "2026-07-09T18:00:00Z",
"updated_at": "2026-07-09T18:00:00Z"
}Renombrar un grupo
POST /v1/organizations/rbac_groups/{rbac_group_id} actualiza el grupo. name es el único campo que este endpoint puede cambiar. Requiere el alcance write:rbac_groups.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Actualizar grupoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
group = client.beta.organization.rbac_groups.update(
"rbac_group_01UvWxYzAbCdEfGhIjKlMn", name="Platform Engineering"
)
print(f"id: {group.id}")
print(f"name: {group.name}")Eliminar un grupo
DELETE /v1/organizations/rbac_groups/{rbac_group_id} elimina el grupo. Sus miembros siguen siendo miembros de sus organizaciones, pero pierden los permisos de los roles asociados, y un límite de gasto de grupo, si existía, deja de aplicárseles. Requiere el alcance write:rbac_groups.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Eliminar grupoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
deleted_group = client.beta.organization.rbac_groups.delete(
"rbac_group_01UvWxYzAbCdEfGhIjKlMn"
)
print(f"id: {deleted_group.id}"){
"id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"type": "rbac_group_deleted"
}Enumerar los miembros de un grupo
GET /v1/organizations/rbac_groups/{rbac_group_id}/members devuelve los miembros del grupo (cada uno con su user_id y correo electrónico), empezando por los más antiguos. Solo se devuelven los miembros actuales de las organizaciones de tu empresa, por lo que una página puede contener menos de limit entradas mientras has_more es true. Requiere el alcance read:rbac_groups.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Listar miembros de un grupoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
members = client.beta.organization.rbac_groups.members.list(
"rbac_group_01UvWxYzAbCdEfGhIjKlMn", limit=100
)
for member in members:
print(f"{member.user_id}: {member.email}"){
"data": [
{
"type": "rbac_group_member",
"rbac_group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
"email": "jane@example.com",
"created_at": "2026-04-07T12:30:00Z"
}
],
"has_more": false,
"next_page": null
}Agregar un miembro a un grupo
POST /v1/organizations/rbac_groups/{rbac_group_id}/members agrega un miembro de la organización al grupo por user_id. El usuario ya debe ser miembro de una de las organizaciones de tu empresa (de lo contrario, la solicitud devuelve 404), y agregar a alguien que ya está en el grupo devuelve 400. Para los grupos scim, la membresía se gestiona en tu proveedor de identidad y esta solicitud devuelve 400. Para asignar grupos a una persona que aún no se ha unido, usa rbac_group_ids en la creación de invitaciones en su lugar. Requiere el alcance write:rbac_groups.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Agregar miembro a grupoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
member = client.beta.organization.rbac_groups.members.add(
"rbac_group_01UvWxYzAbCdEfGhIjKlMn", user_id="user_01AbCdEfGhIjKlMnOpQrSt"
)
print(f"user_id: {member.user_id}")
print(f"email: {member.email}"){
"type": "rbac_group_member",
"rbac_group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
"email": "jane@example.com",
"created_at": "2026-07-09T18:00:00Z"
}Eliminar un miembro de un grupo
DELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id} elimina al miembro del grupo; sigue siendo miembro de su organización. La solicitud devuelve 404 si el usuario no es miembro del grupo, y 400 para los grupos scim, cuya membresía se gestiona en tu proveedor de identidad. Requiere el alcance write:rbac_groups.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Quitar miembro de grupoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
removed_member = client.beta.organization.rbac_groups.members.remove(
"user_01AbCdEfGhIjKlMnOpQrSt", rbac_group_id="rbac_group_01UvWxYzAbCdEfGhIjKlMn"
)
print(f"user_id: {removed_member.user_id}"){
"rbac_group_id": "rbac_group_01UvWxYzAbCdEfGhIjKlMn",
"user_id": "user_01AbCdEfGhIjKlMnOpQrSt",
"type": "rbac_group_member_deleted"
}Roles personalizados
Los roles personalizados son de solo lectura a través de la API: estos endpoints catalogan los roles personalizados de tu organización (definidos en la configuración de la organización de claude.ai o aprovisionados por Anthropic) y los permisos que otorga cada rol. Las lecturas de roles personalizados usan el alcance read:members (no existe un alcance de roles separado) y funcionan con una clave a nivel de organización, y el catálogo devuelto es el de tu propia organización.
Lee el nombre de un rol desde su campo display_name. Para un rol aprovisionado por Anthropic, display_name puede diferir de la etiqueta que muestra claude.ai, y Anthropic podría cambiar el nombre. Para mantener una referencia duradera a un rol, almacena su id.
Enumerar roles
GET /v1/organizations/rbac_roles devuelve los roles personalizados de tu organización. Requiere el alcance read:members.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Listar rolesVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
roles = client.beta.organization.rbac_roles.list(limit=20)
for role in roles:
print(f"{role.id}: {role.display_name}"){
"data": [
{
"type": "rbac_role",
"id": "rbac_role_01CdEfGhIjKlMnOpQrStUv",
"display_name": "Engineering base",
"created_at": "2026-03-18T10:01:42Z",
"updated_at": "2026-05-02T08:55:09Z"
}
],
"has_more": false,
"next_page": null
}Obtener un rol
GET /v1/organizations/rbac_roles/{rbac_role_id} devuelve un rol por ID. Requiere el alcance read:members.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Obtener rolVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
role = client.beta.organization.rbac_roles.retrieve("rbac_role_01CdEfGhIjKlMnOpQrStUv")
print(f"id: {role.id}")
print(f"display_name: {role.display_name}")Enumerar los permisos de un rol
GET /v1/organizations/rbac_roles/{rbac_role_id}/permissions devuelve los permisos del rol. Cada permiso combina un resource (a qué se aplica: las funciones de producto de la organización, una herramienta de conector, un alcance OAuth de conector, un conector o todos los conectores) con una action (lo que otorga sobre ese recurso). Se omiten las filas de funciones que no están habilitadas para tu organización, por lo que una página puede contener menos de limit filas mientras has_more es true. Requiere el alcance read:members.
Dos valores de action requieren especial cuidado. Un permiso organization cuya acción es capability_access_all (todas las funciones de producto) o capability_access_all_ga (todas las funciones de producto estables, es decir, todas las funciones no etiquetadas como beta o vista previa de investigación) es una concesión general. Se enumera como esa única fila en lugar de expandirse. Una concesión general no cubre ni el acceso a modelos ni los permisos del panel de administración con prefijo permission_, ni inference_hooks_inspection, que un rol solo tiene mediante una fila que lo nombre. Cuando hagas el recuento de lo que otorga un rol, trata una fila de concesión general como si cubriera todo lo que describe su variante, no solo las funciones nombradas en otras filas.
Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta Listar permisos de un rolVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. en la referencia de la API.
client = anthropic.Anthropic()
permissions = client.beta.organization.rbac_roles.permissions.list(
"rbac_role_01CdEfGhIjKlMnOpQrStUv", limit=20
)
for permission in permissions:
print(permission.action){
"data": [
{
"type": "rbac_role_permission",
"resource": {
"type": "organization",
"organization_id": "12345678-1234-5678-1234-567812345678"
},
"action": "capability_access_all_ga"
},
{
"type": "rbac_role_permission",
"resource": {
"type": "connector_tool",
"connector_id": "mcpsrv_01WxYzAbCdEfGhIjKlMnOp",
"tool_name": "search_tickets"
},
"action": "use"
}
],
"has_more": false,
"next_page": null
}Flujos de trabajo de ejemplo
Dar de baja a un empleado que se va
-
Busca al miembro por correo electrónico:
Pythonclient = anthropic.Anthropic() users = client.organization.users.list(email="departing@example.com") for user in users: print(f"{user.id}: {user.email} ({user.role})") -
Elimínalo con
DELETE /v1/organizations/users/{user_id}, usando elidde la respuesta. Su asiento, si lo tenía, vuelve al grupo. -
Si la persona aún no se había unido, la búsqueda no devuelve ningún miembro; en ese caso, enumera las invitaciones y retira su invitación
pending.
Responder ante un dispositivo perdido o robado
Antes de necesitar este flujo de trabajo, crea una clave con los alcances write:members y read:members para el endpoint de cierre de sesión. Si aún no tienes una clave, un propietario puede usar la acción Cerrar sesión en todos lados en la página Miembros de la configuración de la organización de claude.ai en lugar de los pasos 2 a 4. Un propietario no puede usarla en su propia cuenta: cierra sus propias sesiones desde la configuración de su cuenta en claude.ai.
-
Primero, cierra la sesión de la persona en tu proveedor de identidad, o desactiva su cuenta allí. De lo contrario, quien tenga el dispositivo perdido puede volver a iniciar sesión en Claude mediante la sesión del proveedor de identidad de ese dispositivo o el buzón de correo de la persona.
-
Busca al miembro por dirección de correo electrónico, como en el paso 1 de Dar de baja a un empleado que se va. La coincidencia de correo tolera variantes de la misma dirección, así que comprueba que la respuesta corresponda a la persona correcta.
-
Cierra su sesión con
POST /v1/organizations/users/{user_id}/sign_out, usando elidde la respuesta. Cerrar la sesión de un miembro en todas partes enumera los encabezados que necesita la solicitud y lo que finaliza. -
Si la solicitud devuelve 503, envíala de nuevo hasta que devuelva 200. Si devuelve 400 con
cannot_sign_out_primary_owner, consulta A quién no puedes cerrarle la sesión. -
Revisa la exportación del registro de auditoría o el Activity Feed en busca de un inicio de sesión posterior a la primera solicitud. Si encuentras uno, o si la persona estaba iniciando sesión en una aplicación como Claude Code, envía la solicitud de nuevo después de 5 minutos. Si no puedes enviar la solicitud, usa de nuevo la acción Cerrar sesión en todos lados en su lugar. Esto también cierra la sesión del miembro en cualquier sesión que haya iniciado desde entonces, así que avísale primero.
-
Confirma el cierre de sesión donde se registra y revisa lo que la solicitud no finaliza.
Auditar la membresía de los grupos
-
Enumera los grupos y registra el
id, elnamey losrole_idsde cada grupo. -
Para cada grupo que tenga roles sensibles, recorre las páginas de
GET /v1/organizations/rbac_groups/{rbac_group_id}/membersy compara los correos electrónicos de los miembros con la lista de tu proveedor de identidad. -
Elimina a los miembros que ya no deberían estar en el grupo con
DELETE /v1/organizations/rbac_groups/{rbac_group_id}/members/{user_id}. Para los gruposscim, haz el cambio en tu proveedor de identidad en su lugar.
Para un flujo de trabajo que combina la membresía de grupos con un aumento temporal del límite de gasto, consulta Aumentar temporalmente el límite de gasto de un miembro durante un incidente en la página de la API de Límites de Gasto.
Preguntas frecuentes
¿Es esta una API diferente de la Admin API?
No. Los endpoints de miembros e invitaciones son los mismos endpoints /v1/organizations/ que usan las organizaciones de Claude Console; esta página documenta su comportamiento en Claude Enterprise. Los endpoints de grupos y roles personalizados forman parte de la misma API y existen solo para organizaciones de Claude Enterprise. La tabla de disponibilidad muestra qué endpoints puede llamar cada tipo de organización.
¿Puede la API asignar el rol de propietario o de administrador de membresía?
No. La API solo asigna user y managed, al crear invitaciones y al actualizar roles. Los roles administrativos se asignan en la configuración de la organización de claude.ai, y los miembros que los tienen no pueden modificarse ni eliminarse a través de la API.
¿Puede la API crear o modificar grupos?
Sí, con el alcance write:rbac_groups: crear, renombrar y eliminar grupos, y agregar o quitar sus miembros. Hay dos cosas que la API no puede cambiar: los grupos aprovisionados por tu proveedor de identidad (source_type: "scim"), cuyo nombre y membresía pertenecen al proveedor de identidad, y los roles personalizados, que se administran en la configuración de la organización de claude.ai (la API los lee).
¿Una invitación no aceptada consume un asiento?
En los planes con un grupo finito de asientos, sí: una invitación pending ocupa un asiento. Retirar la invitación o dejar que expire libera el asiento. En los planes sin grupo de asientos, las invitaciones no consumen nada.
¿Qué operaciones funcionan cuando tu organización usa inicio de sesión único?
Si tu proveedor de identidad aprovisiona usuarios automáticamente (JIT o SCIM), la creación de invitaciones devuelve 400. Si gestiona los roles (SSO avanzado o aprovisionamiento SCIM avanzado), las actualizaciones de roles devuelven 400. Si gestiona la membresía (aprovisionamiento SCIM), las eliminaciones de miembros devuelven 400. Las lecturas funcionan en cualquier caso. Lo mismo ocurre con cerrar la sesión de un miembro en todas partes, sea cual sea el modo de inicio de sesión único que use tu organización.
¿Cerrar la sesión de un miembro lo mantiene fuera?
No. Cerrar la sesión de un miembro finaliza sus sesiones iniciadas, sus dispositivos de confianza y sus tokens de OAuth para tu organización, pero puede volver a iniciar sesión de inmediato. Para mantener a alguien fuera, elimínalo o, si tu organización requiere inicio de sesión único, desactiva su cuenta en tu proveedor de identidad. Desactivar la cuenta por sí solo podría no finalizar las sesiones que ya están abiertas, así que primero cierra la sesión de la persona en tu proveedor de identidad, luego cierra su sesión en Claude y después elimínala o desactiva su cuenta.
¿Qué ocurre con una clave de Admin API cuando la persona que la creó se va?
La clave sigue funcionando. Las claves de Admin API están asociadas a la organización, no a usuarios individuales, y una clave creada en claude.ai no caduca. Eliminar al creador de la organización o desaprovisionarlo a través de tu proveedor de identidad pone fin a su propio acceso, pero no a las claves que creó. Reducir su rol tampoco cambia las claves: cada clave permanece activa con sus alcances originales. Cuando des de baja a alguien que creó claves de Admin API, elimina esas claves en la sección Claves de claude.ai > Configuración de la organización > API y crea reemplazos.
Consulta también
Dónde crear una clave con alcances y qué alcances seleccionar.
Audita la actividad y recupera o elimina contenido de usuarios en toda tu organización.
Realiza un seguimiento del uso de tokens y los costos de tu organización.
Establece límites de gasto por miembro y revisa las solicitudes de aumento.
¿Te resultó útil esta página?