Listar organizaciones, usuarios, roles y grupos

Los endpoints de esta página exponen el lado de directorio de una organización de Claude Enterprise: sus organizaciones vinculadas, los usuarios de cada una, los roles definidos en cada una y sus grupos de "role-based access control" (control de acceso basado en roles), o RBAC, o aprovisionados mediante SCIM ("System for Cross-domain Identity Management", sistema para la gestión de identidades entre dominios), junto con sus miembros. Úsalos para poblar listas de usuarios de eDiscovery, crear paneles de informes y conciliar la pertenencia a grupos con un sistema de registro externo. Las Compliance Access Keys están vinculadas a una organización principal y devuelven datos de todas las organizaciones vinculadas bajo ella, por lo que una sola clave alcanza todo el árbol.

Listar organizaciones

El endpoint List organizations devuelve todas las organizaciones bajo la organización principal a la que está vinculada la clave.

La siguiente llamada lista todas las organizaciones bajo tu organización principal. La respuesta es un único arreglo data de registros de organización ordenados por created_at de forma ascendente. El endpoint devuelve hasta 1000 organizaciones en una sola llamada; si tu árbol supera ese número, devuelve un error 500.

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
      "name": "Acme Engineering",
      "created_at": "2025-06-01T10:00:00Z"
    },
    {
      "uuid": "5a1b2c3d-4e5f-6789-abcd-ef0123456789",
      "name": "Acme Legal",
      "created_at": "2025-07-15T14:30:00Z"
    }
  ]
}

El campo uuid es el identificador canónico para las búsquedas posteriores. La siguiente tabla lo relaciona con los demás identificadores de organización en la Compliance API:

La mayoría de las demás API de Anthropic usan la forma con prefijo org_.

Si tu árbol supera el límite de 1000 organizaciones, contacta al soporte de Anthropic. Para hacer seguimiento de los cambios de pertenencia a organizaciones a lo largo del tiempo, vuelve a listar este endpoint periódicamente. El Activity Feed también expone eventos de pertenencia a través de los tipos de actividad org_deletion_requested, org_deleted_via_bulk, org_parent_join_proposal_created y org_join_proposal_decided; consulta Consultar el Activity Feed.

Listar usuarios de la organización

El endpoint List organization users devuelve una lista paginada de registros de usuario para una organización.

Este endpoint requiere read:compliance_user_data, no read:compliance_org_data. Crea la Compliance Access Key con ambos alcances cuando tengas la intención de usarla para la enumeración de directorio; de lo contrario, la llamada devuelve 403 Forbidden.

Consulta List organization users en la referencia de la API para conocer los valores predeterminados y rangos de los parámetros de consulta limit y page.

Los resultados se ordenan por fecha de incorporación a la organización de forma ascendente. A diferencia de los cursores before_id/after_id del Activity Feed (consulta Paginar resultados), los endpoints de directorio paginan con un token next_page: cuando has_more es true, pasa next_page sin modificar como el parámetro de consulta page en la siguiente solicitud.

org_uuid="91012d09-e48b-438e-a489-1bebfd8fa6f9"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/organizations/$org_uuid/users" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "limit=500"

{
  "data": [
    {
      "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "full_name": "Priya Sharma",
      "email": "[email protected]",
      "organization_role": "admin",
      "created_at": "2025-06-01T10:00:00Z"
    }
  ],
  "has_more": true,
  "next_page": "page_8aW5kZXgicG9zaXRpb25fdG9rZW5fOTE0"
}

Los ID de usuario devueltos aquí son los mismos identificadores user_... que acepta el filtro actor_ids[] de Consultar el Activity Feed y el filtro user_ids[] de Recuperar chats y mensajes. El campo organization_role contiene el nivel de pertenencia integrado del usuario dentro de la organización listada (uno de admin, billing, claude_code_user, developer, managed, membership_admin, owner, primary_owner o user), un eje independiente de cualquier asignación de rol RBAC personalizado devuelta por Listar roles. Un flujo típico de eDiscovery lista los usuarios de una o más organizaciones, los filtra contra tus propios registros externos y pasa los ID resultantes a las consultas de chats y proyectos.

Un usuario solo aparece aquí mientras sea miembro activo de la organización. Los usuarios eliminados se quitan de la lista de inmediato. Su actividad histórica sigue siendo consultable a través del Activity Feed durante toda la ventana de retención, indexada por el mismo ID user_....

Listar roles

El endpoint List Compliance Roles devuelve una lista paginada de registros de rol definidos en una organización, y Get Compliance Role devuelve un rol por ID.

Ambos endpoints de roles requieren read:compliance_org_data. El endpoint de listado acepta los mismos parámetros limit y page que Listar usuarios de la organización.

org_uuid="91012d09-e48b-438e-a489-1bebfd8fa6f9"

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/${org_uuid}/roles" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "rbac_role_01N2pQrS8tUvWxYz5AbCdEfGh",
      "name": "Compliance Reviewer",
      "description": "Read-only access to chat and project content for legal review.",
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

Consulta el esquema de respuesta de List Compliance Roles para ver la estructura completa del registro de rol. Para listar los permisos actualmente otorgados a un rol, usa List Compliance Role Permissions. Para auditar asignaciones de roles históricas y cambios de permisos, consulta los tipos de actividad de RBAC (por ejemplo, rbac_role_assigned y rbac_role_permission_added) a través del Activity Feed; consulta Filtrar actividades.

Listar grupos y miembros

El endpoint List Compliance Groups devuelve una lista paginada de grupos RBAC y aprovisionados mediante SCIM, y Get Compliance Group devuelve un grupo por ID. El endpoint List Compliance Group Members devuelve los miembros de un grupo.

Los endpoints de listado y recuperación de grupos requieren read:compliance_org_data. El endpoint de miembros requiere read:compliance_user_data. Crea la clave con ambos alcances para recorrer los grupos de principio a fin. Ambos endpoints de listado aceptan los mismos parámetros limit y page que Listar usuarios de la organización.

Consulta el esquema de respuesta de List Compliance Groups para ver la estructura completa del registro de grupo. El arreglo roles lista los ID de rol asignados al grupo, que coinciden con los ID de Listar roles. source_type es el discriminador entre grupos creados manualmente a través de claude.ai (direct) y grupos sincronizados desde un proveedor de identidad externo mediante SCIM (scim).

Lista los grupos y luego, para cada grupo, lista sus miembros:

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/groups" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "rbac_group_01P9qRsTuVwXyZa2BcDeFgHjK",
      "name": "Engineering",
      "description": "Engineering team members",
      "source_type": "scim",
      "roles": ["rbac_role_01N2pQrS8tUvWxYz5AbCdEfGh"],
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

Para cada ID de grupo, lista sus miembros:

group_id="rbac_group_01P9qRsTuVwXyZa2BcDeFgHjK"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/groups/$group_id/members" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "user_id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "email": "[email protected]",
      "created_at": "2025-06-01T10:00:00Z",
      "updated_at": "2025-06-15T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_page": null
}

Consulta el esquema de respuesta de List Compliance Group Members para ver la estructura completa del registro de miembro. El campo user_id es el mismo identificador user_... que aceptan el Activity Feed y la lista de chats. Para obtener el nombre completo de un miembro, búscalo a través de la lista de usuarios de la organización.

Próximos pasos