---
title: Listar organizaciones, usuarios, roles, grupos y configuraciones
url: https://platform.claude.com/docs/es/manage-claude/compliance-org-data
description: Enumera las organizaciones bajo tu organización principal (sus usuarios, roles y grupos) y lee la configuración efectiva de cada organización a través de la Compliance API.
---

<Note>
  Para habilitar la Compliance API, consulta [Configurar la Compliance API](https://platform.claude.com/docs/es/manage-claude/compliance-api-access).
</Note>

<Check>
  **Alcance requerido:** `read:compliance_org_data` en la Compliance Access Key. Los endpoints de usuarios, de preferencias de usuario y de miembros de grupos requieren `read:compliance_user_data` en su lugar.

  Las Compliance Access Keys (`sk-ant-api01-...`) creadas en claude.ai son el único tipo de clave aceptado; consulta [Configurar la Compliance API](https://platform.claude.com/docs/es/manage-claude/compliance-api-access) para aprovisionar una. Las llamadas autenticadas con una clave de Admin API (`sk-ant-admin01-...`) devuelven [403 Forbidden](https://platform.claude.com/docs/es/manage-claude/compliance-errors#403-forbidden).
</Check>

Los endpoints de esta página exponen el lado de directorio de una organización 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 "System for Cross-domain Identity Management" (sistema de gestión de identidades entre dominios), o SCIM, y sus miembros. Úsalos para alimentar listas de usuarios de eDiscovery, crear paneles de informes y conciliar la membresía de grupos con un sistema de registro externo. Una Compliance Access Key que cubre la organización principal devuelve datos de todas las organizaciones vinculadas debajo de ella, por lo que una sola clave alcanza todo el árbol. El [endpoint de configuración efectiva](https://platform.claude.com/docs/es/manage-claude/compliance-org-data#get-effective-organization-settings) complementa el directorio: devuelve la configuración de privacidad de datos, seguridad y capacidades realmente vigente para una organización.

## Listar organizaciones

El endpoint [Listar organizaciones](https://platform.claude.com/docs/es/api/compliance/organizations/list) 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 arreglo `data` de registros de organizaciones ordenados por `created_at` de forma ascendente, además de `has_more` y `next_page` para la paginación. Cuando `has_more` es `true`, pasa el token `next_page` devuelto sin modificar como el parámetro de consulta `page` en tu siguiente solicitud. Consulta [Listar organizaciones](https://platform.claude.com/docs/es/api/compliance/organizations/list) en la referencia de la API para conocer los valores predeterminados y rangos de los parámetros `limit` y `page`.

```bash cURL
curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2023-06-01"
```

```json Response
{
  "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"
    }
  ],
  "has_more": false,
  "next_page": null
}
```

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

| Campo                | Dónde                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Relación con `uuid`                                                                                                                                                    |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{org_uuid}`         | Parámetro de ruta en los endpoints por organización de esta página                                                                                                                                                                                                                                                                                                                                                                                      | Mismo valor                                                                                                                                                            |
| `organization_uuid`  | Registros del Activity Feed, chats, proyectos y sesiones                                                                                                                                                                                                                                                                                                                                                                                                | Mismo valor; une directamente por estos dos campos                                                                                                                     |
| `organization_id`    | Registros del Activity Feed, chats y proyectos                                                                                                                                                                                                                                                                                                                                                                                                          | Misma organización, con prefijo `org_`. Obsoleto en registros de chats y proyectos; usa `organization_uuid` en su lugar.                                               |
| `organization_ids[]` | Filtro en [Consultar el Activity Feed](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed), [Recuperar chats y mensajes](https://platform.claude.com/docs/es/manage-claude/compliance-content-data#retrieve-chats-and-messages) y la [lista de sesiones remotas](https://platform.claude.com/docs/es/manage-claude/compliance-sessions#retrieve-remote-sessions) (la lista de sesiones locales no tiene filtro de organización) | Acepta `uuid` o la forma con prefijo `org_`                                                                                                                            |
| `organization_id`    | Respuesta de [Configuración efectiva de la organización](https://platform.claude.com/docs/es/manage-claude/compliance-org-data#get-effective-organization-settings)                                                                                                                                                                                                                                                                                     | Mismo valor, UUID sin prefijo; esta respuesta **no** usa la forma con prefijo `org_` que `organization_id` lleva en los registros del Activity Feed, chats y proyectos |

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

Para rastrear los cambios de membresía de organizaciones a lo largo del tiempo, vuelve a listar este endpoint periódicamente, siguiendo el token `next_page` a través de todas las páginas en cada pasada. El Activity Feed también muestra eventos de membresía 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](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed).

## Listar usuarios de la organización

El endpoint [Listar usuarios de la organización](https://platform.claude.com/docs/es/api/compliance/organizations/users/list) devuelve una lista paginada de registros de usuarios 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 pretendas usarla para la enumeración del directorio; de lo contrario, la llamada devuelve [403 Forbidden](https://platform.claude.com/docs/es/manage-claude/compliance-errors#403-forbidden).

Consulta [Listar usuarios de la organización](https://platform.claude.com/docs/es/api/compliance/organizations/users/list) 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](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed#paginate-results)), 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.

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

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

```json Response
{
  "data": [
    {
      "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "full_name": "Priya Sharma",
      "email": "priya@example.com",
      "organization_role": "admin",
      "created_at": "2025-06-01T10:00:00Z"
    }
  ],
  "has_more": true,
  "next_page": "page_8aW5kZXgicG9zaXRpb25fdG9rZW5fOTE0"
}
```

Los IDs de usuario devueltos aquí son los mismos identificadores `user_...` que acepta el filtro `actor_ids[]` de [Consultar el Activity Feed](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed) y los filtros `user_ids[]` de [Recuperar chats y mensajes](https://platform.claude.com/docs/es/manage-claude/compliance-content-data#retrieve-chats-and-messages) y la [lista de sesiones remotas](https://platform.claude.com/docs/es/manage-claude/compliance-sessions#retrieve-remote-sessions); la [lista de sesiones locales](https://platform.claude.com/docs/es/manage-claude/compliance-sessions#retrieve-local-sessions) no tiene filtro de usuario, así que atribuye las sesiones locales mediante el `user.id` de cada objeto de sesión. El campo `organization_role` contiene el nivel de membresía 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 roles RBAC personalizados devuelta por [Listar roles](https://platform.claude.com/docs/es/manage-claude/compliance-org-data#list-roles). Un flujo típico de eDiscovery lista los usuarios de una o más organizaciones, los filtra contra tus propios registros externos y alimenta los IDs resultantes en 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 preferencias de usuario

El endpoint `GET /v1/compliance/organizations/{org_uuid}/user_preferences` devuelve el texto que los miembros actuales de una organización guardaron como **Instructions for Claude** en claude.ai (`conversation_preferences`) y como **Global instructions** en Cowork (`cowork_global_instructions`). Ambas son configuraciones a nivel de cuenta, por lo que se devuelve el mismo texto en cada organización a la que pertenece un miembro. Este endpoint está en beta.

Este endpoint requiere `read:compliance_user_data`, no `read:compliance_org_data`; una llamada con una clave que no tenga `read:compliance_user_data` devuelve [403 Forbidden](https://platform.claude.com/docs/es/manage-claude/compliance-errors#403-forbidden).

De forma predeterminada, la respuesta lista solo a los miembros que han establecido al menos uno de los dos valores. Pasa `include_unset=true` para listar a todos los miembros actuales, con `null` para cada valor que no esté establecido. Para devolver solo miembros específicos, pasa hasta 10 IDs de usuario en `user_ids[]`. Los resultados se paginan con `limit` (predeterminado 20, máximo 100) y `page`. Al igual que en el [endpoint de usuarios de la organización](https://platform.claude.com/docs/es/manage-claude/compliance-org-data#list-organization-users), pasa `next_page` sin cambios como `page`; envía también los mismos valores de `include_unset` y `user_ids[]` con cada página, o la llamada devolverá [400 Bad Request](https://platform.claude.com/docs/es/manage-claude/compliance-errors#invalid-pagination-cursor). Una página puede contener menos resultados que `limit`, o ninguno, y aun así no ser la última, así que sigue solicitando páginas hasta que `next_page` sea `null`.

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

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/$org_uuid/user_preferences" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2023-06-01"
```

```json Response
{
  "data": [
    {
      "user": {
        "id": "user_01XyDMpzjS89pFZXqSFUBDr6",
        "email_address": "priya@example.com"
      },
      "conversation_preferences": "Keep answers brief and cite sources.",
      "cowork_global_instructions": null
    }
  ],
  "has_more": false,
  "next_page": null
}
```

## Listar roles

El endpoint [List Compliance Roles](https://platform.claude.com/docs/es/api/compliance/organizations/roles/list) devuelve una lista paginada de registros de roles definidos en una organización, y [Get Compliance Role](https://platform.claude.com/docs/es/api/compliance/organizations/roles/retrieve) devuelve un rol por ID.

Ambos endpoints de roles requieren `read:compliance_org_data`. El endpoint de lista acepta los mismos parámetros `limit` y `page` que el [endpoint de usuarios de la organización](https://platform.claude.com/docs/es/manage-claude/compliance-org-data#list-organization-users).

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

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/${org_uuid}/roles" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2023-06-01"
```

```json Response
{
  "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](https://platform.claude.com/docs/es/api/compliance/organizations/roles/list) para conocer la forma completa del registro de rol. Para listar los permisos actualmente otorgados a un rol, usa [List Compliance Role Permissions](https://platform.claude.com/docs/es/api/compliance/organizations/roles/permissions/list). Para auditar las asignaciones históricas de roles y los cambios de permisos, consulta los tipos de actividad RBAC (por ejemplo, `rbac_role_assigned` y `rbac_role_permission_added`) a través del Activity Feed; consulta [Filtrar actividades](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed#filter-activities).

## Listar grupos y miembros

El endpoint [List Compliance Groups](https://platform.claude.com/docs/es/api/compliance/groups/list) devuelve una lista paginada de grupos RBAC y aprovisionados mediante SCIM, y [Get Compliance Group](https://platform.claude.com/docs/es/api/compliance/groups/retrieve) devuelve un grupo por ID. El endpoint [List Compliance Group Members](https://platform.claude.com/docs/es/api/compliance/groups/members/list) devuelve los miembros de un grupo.

Los endpoints de lista 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 lista aceptan los mismos parámetros `limit` y `page` que el [endpoint de usuarios de la organización](https://platform.claude.com/docs/es/manage-claude/compliance-org-data#list-organization-users).

Consulta el esquema de respuesta de [List Compliance Groups](https://platform.claude.com/docs/es/api/compliance/groups/list) para conocer la forma completa del registro de grupo. El arreglo `roles` lista los IDs de roles asignados al grupo, que coinciden con los IDs de [Listar roles](https://platform.claude.com/docs/es/manage-claude/compliance-org-data#list-roles). `source_type` es el discriminador entre los grupos creados manualmente a través de claude.ai (`direct`) y los grupos sincronizados desde un proveedor de identidad externo mediante SCIM (`scim`).

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

```bash cURL
curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/groups" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2023-06-01"
```

```json Response
{
  "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:

```bash cURL
group_id="rbac_group_01P9qRsTuVwXyZa2BcDeFgHjK"

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/groups/$group_id/members" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2023-06-01"
```

```json Response
{
  "data": [
    {
      "user_id": "user_01XyDMpzjS89pFZXqSFUBDr6",
      "email": "priya@example.com",
      "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](https://platform.claude.com/docs/es/api/compliance/groups/members/list) para conocer la forma completa del registro de miembro. El campo `user_id` es el mismo identificador `user_...` que aceptan el Activity Feed, la lista de chats y la lista de sesiones remotas; también coincide con `user.id` en los objetos de sesiones locales y en los objetos de sesiones remotas propiedad de usuarios (las sesiones remotas propiedad de agentes llevan el ID del humano en `started_by_user.id` en su lugar). Para obtener el nombre completo de un miembro, búscalo a través de la lista de usuarios de la organización.

## Obtener la configuración efectiva de la organización

El endpoint [Obtener la configuración efectiva de la organización](https://platform.claude.com/docs/es/api/compliance/organizations/settings/retrieve) devuelve la configuración vigente para una organización bajo tu organización principal: el estado aplicado después de que se aplican las restricciones regulatorias (como HIPAA), las reglas de disponibilidad de funciones, los valores predeterminados por tipo de organización y las dependencias entre funciones, lo cual puede diferir de lo que configuró un administrador. Úsalo para certificar que las ventanas de retención, la redacción de contenido, la aplicación del inicio de sesión único, la lista de IPs permitidas y los controles de duración de sesión coinciden con tu línea base documentada, sin acceso de administrador a la Console.

Este endpoint requiere `read:compliance_org_data`; una clave sin ese alcance devuelve [403 Forbidden](https://platform.claude.com/docs/es/manage-claude/compliance-errors#403-forbidden). El objetivo debe ser una de las organizaciones vinculadas de la organización principal: la organización principal en sí no es un objetivo válido. Una organización desconocida, un ID de organización que no es un UUID válido, una organización fuera del árbol de tu organización principal y una organización principal que aún no tiene acceso a este endpoint devuelven todos el mismo [404 Not Found](https://platform.claude.com/docs/es/manage-claude/compliance-errors#404-not-found), por lo que un 404 no revela si una organización existe. El endpoint de configuración se habilita por organización principal de forma separada del resto de la Compliance API; si todas las solicitudes devuelven 404, contacta a tu representante de Anthropic.

<Note>
  Antes del 30 de junio de 2026, este endpoint requería el alcance separado `read:compliance_org_settings`. Ese alcance ha sido retirado: ya no se puede seleccionar ni otorgar al crear una clave, y una clave que solo lleva el alcance retirado devuelve [403 Forbidden](https://platform.claude.com/docs/es/manage-claude/compliance-errors#403-forbidden). Crea una nueva Compliance Access Key con `read:compliance_org_data` en su lugar.
</Note>

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

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/$org_uuid/settings" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2023-06-01"
```

La respuesta es una lista de filas de configuración tipadas, y qué filas aparecen varía según la organización: una configuración que los administradores de la organización no pueden cambiar, porque está controlada por la política de Anthropic o no está disponible para la organización, se omite de la lista. Trata una fila faltante como "no controlable por los administradores de esta organización", no como "desactivada". El siguiente ejemplo abreviado muestra tres de las filas que puede contener una respuesta:

```json Response
{
  "type": "effective_organization_settings",
  "organization_id": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
  "settings": [
    {
      "name": "data_retention_periods",
      "type": "data_retention",
      "value": {
        "chat": {
          "type": "fixed",
          "timescale": "day",
          "duration": 90
        }
      }
    },
    {
      "name": "content_redaction_enabled",
      "type": "boolean",
      "value": true
    },
    {
      "name": "ip_allowlist_ip_ranges",
      "type": "string_list",
      "value": ["10.0.0.0/8", "203.0.113.0/24"]
    }
  ],
  "api_keys": [
    {
      "type": "compliance_api_key",
      "id": "apikey_01Hx7k2mP9nQ4rS6tU8vW0xY",
      "name": "Compliance Export Key",
      "scopes": ["read:compliance_activities", "read:compliance_org_data"],
      "is_active": true,
      "created_at": "2026-03-14T09:30:00Z",
      "created_by_id": "user_01Jz3a4bC5dE6fG7hI8jK9lM",
      "expires_at": null
    }
  ]
}
```

Cada fila lleva `name`, `type` y `value`; el campo `type` (`boolean`, `integer`, `string_list`, `provisioning_mode` o `data_retention`) te indica la forma de `value`. La lista completa de nombres de configuración, y el esquema de `value` para cada tipo, está en [Obtener la configuración efectiva de la organización](https://platform.claude.com/docs/es/api/compliance/organizations/settings/retrieve) en la referencia de la API.

El arreglo `api_keys` lista todas las Compliance Access Keys configuradas para tu organización principal, por lo que se devuelve la misma lista independientemente de qué organización vinculada consultes. Cada entrada lleva el `type` de la clave (`compliance_api_key`), `id`, `name`, `scopes`, el indicador `is_active`, las marcas de tiempo `created_at` y `expires_at`, y `created_by_id` (el ID del usuario que creó la clave; puede ser `null`). El valor secreto de la clave nunca se devuelve. Las claves desactivadas se incluyen con `is_active: false` para que puedas revisar las claves que anteriormente tenían acceso, y las claves que solo llevan el alcance retirado `read:compliance_org_settings` permanecen en la lista para visibilidad de auditoría y limpieza, aunque ese alcance ya no otorga acceso.

El `organization_id` de nivel superior es el UUID sin prefijo de la organización: el mismo valor que `uuid` en la lista de organizaciones, no la forma con prefijo `org_` que `organization_id` lleva en los registros del Activity Feed, chats y proyectos (consulta la [tabla de identificadores de organización](https://platform.claude.com/docs/es/manage-claude/compliance-org-data#list-organizations)).

Las filas reflejan el estado aplicado en lugar de la última configuración almacenada: por ejemplo, `sso_provisioning_mode` informa un modo SCIM configurado solo mientras la sincronización de directorio está habilitada, `ip_allowlist_enabled` es `true` solo mientras la lista de permitidos está activada y tiene al menos un rango activo, y `code_execution_network_egress_enabled` es `false` siempre que la ejecución de código está desactivada.

La respuesta refleja el estado en el momento de la lectura; no se toma ninguna instantánea. Los cambios en la mayoría de estas configuraciones aparecen como eventos en el [Activity Feed](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed); usa este endpoint para el estado resuelto actual y el feed para auditar quién cambió qué y cuándo.

## Leer plugins y marketplaces de plugins

Los plugins y marketplaces de plugins de tu organización forman parte de la [Admin API](https://platform.claude.com/docs/es/manage-claude/plugins-api) y no de la Compliance API, pero una Compliance Access Key con `read:compliance_org_data` puede llamar directamente a los endpoints de lectura de la Plugins API:

* Listar plugins y recuperar un plugin
* Listar las versiones de un plugin, recuperar una versión y descargar los archivos de una versión
* Listar la configuración de instalación de un plugin y sus elementos compartidos
* Listar marketplaces de plugins y recuperar un marketplace

Envía el encabezado `anthropic-beta: ce-plugins-2026-09-01` en cada solicitud; sin él, estos endpoints devuelven [404 Not Found](https://platform.claude.com/docs/es/manage-claude/plugins-api#error-responses). Cada llamada lee una organización: una clave que cubre la organización principal lee la organización vinculada en la que se creó, a menos que pases el parámetro de consulta `organization_id` (el UUID de una organización vinculada o su ID con el prefijo `org_`) para [leer otra distinta](https://platform.claude.com/docs/es/manage-claude/plugins-api#reading-another-organization-under-the-same-parent), y una clave restringida a una organización solo lee esa organización. Estas llamadas cuentan para los [límites de velocidad](https://platform.claude.com/docs/es/manage-claude/plugins-api#rate-limiting) de la Admin API, no para los de la Compliance API.

Crear o modificar plugins, su configuración de instalación o la configuración de un marketplace requiere una clave de Admin API con `write:plugins`. De las llamadas de lectura, solo la descarga de los archivos de un plugin en el marketplace personal de un miembro registra un evento en el [Activity Feed](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed) (`claude_plugin_archive_accessed`). Consulta la [guía de la Plugins API](https://platform.claude.com/docs/es/manage-claude/plugins-api) para ver cada endpoint, ejemplos de solicitudes y los [eventos que registra la API](https://platform.claude.com/docs/es/manage-claude/plugins-api#activity-feed-events).

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Referencia de la API de organizaciones de Compliance" href="https://platform.claude.com/docs/es/api/compliance/organizations">
    El esquema completo de solicitud y respuesta para cada endpoint de organizaciones, usuarios, roles, grupos y configuración.
  </Card>

  <Card title="Manejar errores de la Compliance API" href="https://platform.claude.com/docs/es/manage-claude/compliance-errors">
    Cargas de error literales y la solución para cada una.
  </Card>
</CardGroup>
