---
title: Listar organizações, usuários, funções, grupos e configurações
url: https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data
description: Enumere as organizações sob sua organização pai (seus usuários, funções e grupos) e leia as configurações efetivas de cada organização por meio da Compliance API.
---

<Note>
  Para habilitar a Compliance API, consulte [Configurar a Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access).
</Note>

<Check>
  **Escopo necessário:** `read:compliance_org_data` na Compliance Access Key. Os endpoints de usuários, de preferências de usuário e de membros de grupos exigem `read:compliance_user_data` em vez disso.

  O único tipo de chave aceito são as Compliance Access Keys (`sk-ant-api01-...`) criadas no claude.ai. Para provisionar uma, consulte [Configurar a Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access). Chamadas autenticadas com uma chave de Admin API (`sk-ant-admin01-...`) retornam [403 Forbidden](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-errors#403-forbidden).
</Check>

Os endpoints desta página expõem o lado de diretório de uma organização Claude Enterprise. Isso inclui suas organizações vinculadas, os usuários e as funções definidas em cada uma delas e seus grupos com seus membros. Esses grupos podem ser de "role-based access control" (controle de acesso baseado em funções), ou RBAC, ou provisionados via "System for Cross-domain Identity Management" (sistema de gerenciamento de identidades entre domínios), ou SCIM. Use esses endpoints para alimentar listas de usuários de "eDiscovery" (descoberta eletrônica), criar painéis de relatórios e reconciliar a associação a grupos com um sistema de registro externo. Uma Compliance Access Key que abrange a organização pai retorna dados de todas as organizações vinculadas abaixo dela, de modo que uma única chave alcança toda a árvore. O [endpoint de configurações efetivas](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data#get-effective-organization-settings) complementa o diretório: ele retorna as configurações de privacidade de dados, segurança e capacidades efetivamente em vigor para uma organização.

## Listar organizações

O endpoint [Listar organizações](https://platform.claude.com/docs/pt-BR/api/compliance/organizations/list) retorna todas as organizações sob a organização pai à qual a chave está vinculada.

A chamada a seguir lista todas as organizações sob sua organização pai. A resposta é um array `data` de registros de organização ordenados por `created_at` em ordem crescente, além de `has_more` e `next_page` para paginação. Quando `has_more` for `true`, passe o token `next_page` retornado de volta, sem alterações, como o parâmetro de consulta `page` na sua próxima requisição. Consulte [Listar organizações](https://platform.claude.com/docs/pt-BR/api/compliance/organizations/list) na referência da API para os valores padrão e intervalos dos parâmetros `limit` e `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
}
```

O campo `uuid` é o identificador canônico para consultas subsequentes. A tabela a seguir o relaciona aos outros identificadores de organização em toda a Compliance API:

| Campo                | Onde                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Relação com `uuid`                                                                                                                                                 |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `{org_uuid}`         | Parâmetro de caminho nos endpoints por organização desta página                                                                                                                                                                                                                                                                                                                                                                                            | Mesmo valor                                                                                                                                                        |
| `organization_uuid`  | Registros do Activity Feed, de chat, de projeto e de sessão                                                                                                                                                                                                                                                                                                                                                                                                | Mesmo valor; faça a junção diretamente por esses dois campos                                                                                                       |
| `organization_id`    | Registros do Activity Feed, de chat e de projeto                                                                                                                                                                                                                                                                                                                                                                                                           | Mesma organização, com prefixo `org_`. Descontinuado nos registros de chat e de projeto; use `organization_uuid` em vez disso.                                     |
| `organization_ids[]` | Filtro em [Consultar o Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed), [Recuperar chats e mensagens](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-content-data#retrieve-chats-and-messages) e na [lista de sessões remotas](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-sessions#retrieve-remote-sessions) (a lista de sessões locais não tem filtro de organização) | Aceita `uuid` ou a forma com prefixo `org_`                                                                                                                        |
| `organization_id`    | Resposta de [Configurações efetivas da organização](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data#get-effective-organization-settings)                                                                                                                                                                                                                                                                                          | Mesmo valor, UUID simples; esta resposta **não** usa a forma com prefixo `org_` que `organization_id` carrega nos registros do Activity Feed, de chat e de projeto |

A maioria das outras APIs da Anthropic usa a forma com prefixo `org_`.

Para acompanhar mudanças na associação de organizações ao longo do tempo, liste novamente este endpoint periodicamente, seguindo o token `next_page` por todas as páginas em cada passagem. O Activity Feed também expõe eventos de associação por meio dos tipos de atividade `org_deletion_requested`, `org_deleted_via_bulk`, `org_parent_join_proposal_created` e `org_join_proposal_decided`; consulte [Consultar o Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed).

## Listar usuários da organização

O endpoint [Listar usuários da organização](https://platform.claude.com/docs/pt-BR/api/compliance/organizations/users/list) retorna uma lista paginada de registros de usuários de uma organização.

Este endpoint exige `read:compliance_user_data`, não `read:compliance_org_data`. Crie a Compliance Access Key com ambos os escopos quando pretender usá-la para enumeração de diretório; caso contrário, a chamada retorna [403 Forbidden](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-errors#403-forbidden).

Consulte [Listar usuários da organização](https://platform.claude.com/docs/pt-BR/api/compliance/organizations/users/list) na referência da API para os valores padrão e intervalos dos parâmetros de consulta `limit` e `page`.

Os resultados são ordenados pela data de entrada na organização em ordem crescente. Diferentemente dos cursores `before_id`/`after_id` do Activity Feed (consulte [Paginar resultados](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed#paginate-results)), os endpoints de diretório paginam com um token `next_page`: quando `has_more` for `true`, passe `next_page` de volta, sem alterações, como o parâmetro de consulta `page` na próxima requisição.

```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"
}
```

Os IDs de usuário retornados aqui são os mesmos identificadores `user_...` aceitos pelo filtro `actor_ids[]` de [Consultar o Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed) e pelos filtros `user_ids[]` em [Recuperar chats e mensagens](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-content-data#retrieve-chats-and-messages) e na [lista de sessões remotas](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-sessions#retrieve-remote-sessions); a [lista de sessões locais](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-sessions#retrieve-local-sessions) não tem filtro de usuário, portanto atribua sessões locais pelo `user.id` em cada objeto de sessão. O campo `organization_role` carrega o nível de associação integrado do usuário dentro da organização listada (um entre `admin`, `billing`, `claude_code_user`, `developer`, `managed`, `membership_admin`, `owner`, `primary_owner` ou `user`), um eixo independente de quaisquer atribuições de funções RBAC personalizadas retornadas por [Listar funções](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data#list-roles). Um fluxo típico de eDiscovery lista usuários de uma ou mais organizações, filtra com base nos seus próprios registros externos e alimenta os IDs resultantes em consultas de chats e projetos.

Um usuário só aparece aqui enquanto for um membro ativo da organização. Usuários removidos são retirados da lista imediatamente. Sua atividade histórica permanece consultável por meio do Activity Feed durante toda a janela de retenção, indexada pelo mesmo ID `user_...`.

## Listar preferências de usuário

O endpoint `GET /v1/compliance/organizations/{org_uuid}/user_preferences` retorna o texto que os membros atuais de uma organização salvaram como **Instructions for Claude** no claude.ai (`conversation_preferences`) e como **Global instructions** no Cowork (`cowork_global_instructions`). Ambas são configurações no nível da conta, portanto o mesmo texto é retornado em todas as organizações às quais um membro pertence. Este endpoint está em beta.

Este endpoint exige `read:compliance_user_data`, não `read:compliance_org_data`; uma chamada com uma chave que não tenha `read:compliance_user_data` retorna [403 Forbidden](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-errors#403-forbidden).

Por padrão, a resposta lista apenas os membros que definiram pelo menos um dos dois valores. Passe `include_unset=true` para listar todos os membros atuais, com `null` para cada valor que não estiver definido. Para retornar apenas membros específicos, passe até 10 IDs de usuário em `user_ids[]`. Os resultados são paginados com `limit` (padrão 20, máximo 100) e `page`. Assim como no [endpoint de usuários da organização](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data#list-organization-users), passe `next_page` de volta, sem alterações, como `page`; envie também os mesmos valores de `include_unset` e `user_ids[]` em todas as páginas, ou a chamada retornará [400 Bad Request](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-errors#invalid-pagination-cursor). Uma página pode conter menos resultados do que `limit`, ou nenhum, e ainda assim não ser a última, portanto continue solicitando páginas até que `next_page` seja `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 funções

O endpoint [List Compliance Roles](https://platform.claude.com/docs/pt-BR/api/compliance/organizations/roles/list) retorna uma lista paginada de registros de funções definidas em uma organização, e [Get Compliance Role](https://platform.claude.com/docs/pt-BR/api/compliance/organizations/roles/retrieve) retorna uma função por ID.

Ambos os endpoints de funções exigem `read:compliance_org_data`. O endpoint de listagem aceita os mesmos parâmetros `limit` e `page` que o [endpoint de usuários da organização](https://platform.claude.com/docs/pt-BR/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
}
```

Consulte o esquema de resposta de [List Compliance Roles](https://platform.claude.com/docs/pt-BR/api/compliance/organizations/roles/list) para o formato completo do registro de função. Para listar as permissões atualmente concedidas a uma função, use [List Compliance Role Permissions](https://platform.claude.com/docs/pt-BR/api/compliance/organizations/roles/permissions/list). Para auditar atribuições históricas de funções e mudanças de permissões, consulte os tipos de atividade RBAC (por exemplo, `rbac_role_assigned` e `rbac_role_permission_added`) por meio do Activity Feed; consulte [Filtrar atividades](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed#filter-activities).

## Listar grupos e membros

O endpoint [List Compliance Groups](https://platform.claude.com/docs/pt-BR/api/compliance/groups/list) retorna uma lista paginada de grupos RBAC e provisionados por SCIM, e [Get Compliance Group](https://platform.claude.com/docs/pt-BR/api/compliance/groups/retrieve) retorna um grupo por ID. O endpoint [List Compliance Group Members](https://platform.claude.com/docs/pt-BR/api/compliance/groups/members/list) retorna os membros de um grupo.

Os endpoints de listagem e recuperação de grupos exigem `read:compliance_org_data`. O endpoint de membros exige `read:compliance_user_data`. Crie a chave com ambos os escopos para percorrer os grupos de ponta a ponta. Ambos os endpoints de listagem aceitam os mesmos parâmetros `limit` e `page` que o [endpoint de usuários da organização](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data#list-organization-users).

Consulte o esquema de resposta de [List Compliance Groups](https://platform.claude.com/docs/pt-BR/api/compliance/groups/list) para o formato completo do registro de grupo. O array `roles` lista os IDs de funções atribuídas ao grupo, correspondendo aos IDs de [Listar funções](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data#list-roles). `source_type` é o discriminador entre grupos criados manualmente por meio do claude.ai (`direct`) e grupos sincronizados de um provedor de identidade externo por meio de SCIM (`scim`).

Liste os grupos e, em seguida, para cada grupo, liste seus membros:

```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, liste seus membros:

```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
}
```

Consulte o esquema de resposta de [List Compliance Group Members](https://platform.claude.com/docs/pt-BR/api/compliance/groups/members/list) para o formato completo do registro de membro. O campo `user_id` é o mesmo identificador `user_...` que o Activity Feed, a lista de chats e a lista de sessões remotas aceitam; ele também corresponde a `user.id` em objetos de sessão local e em objetos de sessão remota pertencentes a usuários (sessões remotas pertencentes a agentes carregam o ID do humano em `started_by_user.id` em vez disso). Para obter o nome completo de um membro, consulte-o por meio da lista de usuários da organização.

## Obter configurações efetivas da organização

O endpoint [Obter configurações efetivas da organização](https://platform.claude.com/docs/pt-BR/api/compliance/organizations/settings/retrieve) retorna as configurações em vigor para uma organização sob sua organização pai: o estado aplicado depois que restrições regulatórias (como HIPAA), regras de disponibilidade de recursos, padrões por tipo de organização e dependências entre recursos são aplicados, o que pode diferir do que um administrador configurou. Use-o para atestar que janelas de retenção, redação de conteúdo, imposição de single sign-on, a lista de permissões de IP e os controles de duração de sessão correspondem à sua linha de base documentada, sem acesso de administrador ao Console.

Este endpoint exige `read:compliance_org_data`; uma chave sem esse escopo retorna [403 Forbidden](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-errors#403-forbidden). O alvo deve ser uma das organizações vinculadas à organização pai: a própria organização pai não é um alvo válido. Uma organização desconhecida, um ID de organização que não seja um UUID válido, uma organização fora da árvore da sua organização pai e uma organização pai que ainda não tenha acesso a este endpoint retornam todos o mesmo [404 Not Found](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-errors#404-not-found), de modo que um 404 não revela se uma organização existe. O endpoint de configurações é habilitado por organização pai separadamente do restante da Compliance API; se todas as requisições retornarem 404, entre em contato com seu representante da Anthropic.

<Note>
  Antes de 30 de junho de 2026, este endpoint exigia o escopo separado `read:compliance_org_settings`. Esse escopo foi desativado: ele não pode mais ser selecionado ou concedido ao criar uma chave, e uma chave que carregue apenas o escopo desativado retorna [403 Forbidden](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-errors#403-forbidden). Crie uma nova Compliance Access Key com `read:compliance_org_data` em vez disso.
</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"
```

A resposta é uma lista de linhas de configuração tipadas, e quais linhas aparecem varia por organização: uma configuração que os administradores da organização não podem alterar, porque é controlada por política da Anthropic ou não está disponível para a organização, é omitida da lista. Trate uma linha ausente como "não controlável pelos administradores desta organização", não como "desativada". O exemplo resumido a seguir mostra três das linhas que uma resposta pode conter:

```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 linha carrega `name`, `type` e `value`; o campo `type` (`boolean`, `integer`, `string_list`, `provisioning_mode` ou `data_retention`) informa o formato de `value`. A lista completa de nomes de configurações, e o esquema de `value` para cada tipo, está em [Obter configurações efetivas da organização](https://platform.claude.com/docs/pt-BR/api/compliance/organizations/settings/retrieve) na referência da API.

O array `api_keys` lista todas as Compliance Access Keys configuradas para sua organização pai, de modo que a mesma lista é retornada independentemente de qual organização vinculada você consultar. Cada entrada carrega o `type` da chave (`compliance_api_key`), `id`, `name`, `scopes`, o sinalizador `is_active`, os timestamps `created_at` e `expires_at`, e `created_by_id` (o ID do usuário que criou a chave; pode ser `null`). O valor secreto da chave nunca é retornado. Chaves desativadas são incluídas com `is_active: false` para que você possa revisar chaves que anteriormente tinham acesso, e chaves que carregam apenas o escopo desativado `read:compliance_org_settings` permanecem na lista para visibilidade de auditoria e limpeza, mesmo que esse escopo não conceda mais acesso.

O `organization_id` de nível superior é o UUID simples da organização: o mesmo valor que `uuid` na lista de organizações, não a forma com prefixo `org_` que `organization_id` carrega nos registros do Activity Feed, de chat e de projeto (consulte a [tabela de identificadores de organização](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-org-data#list-organizations)).

As linhas refletem o estado aplicado em vez da última configuração armazenada: por exemplo, `sso_provisioning_mode` informa um modo SCIM configurado apenas enquanto a sincronização de diretório estiver habilitada, `ip_allowlist_enabled` é `true` apenas enquanto a lista de permissões estiver ativada e tiver pelo menos um intervalo ativo, e `code_execution_network_egress_enabled` é `false` sempre que a execução de código estiver desativada.

A resposta reflete o estado no momento da leitura; nada é capturado em snapshot. Mudanças na maioria dessas configurações aparecem como eventos no [Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed); use este endpoint para o estado resolvido atual e o feed para auditar quem alterou o quê, e quando.

## Ler plugins e marketplaces de plugins

Os plugins e marketplaces de plugins da sua organização fazem parte da [Admin API](https://platform.claude.com/docs/pt-BR/manage-claude/plugins-api), e não da Compliance API, mas uma Compliance Access Key com `read:compliance_org_data` pode chamar diretamente os endpoints de leitura da API de Plugins:

* Listar plugins e recuperar um plugin
* Listar as versões de um plugin, recuperar uma versão e baixar os arquivos de uma versão
* Listar as configurações de instalação de um plugin e seus compartilhamentos
* Listar marketplaces de plugins e recuperar um marketplace

Envie o cabeçalho `anthropic-beta: ce-plugins-2026-09-01` em todas as requisições; sem ele, esses endpoints retornam [404 Not Found](https://platform.claude.com/docs/pt-BR/manage-claude/plugins-api#error-responses). Cada chamada lê uma organização: uma chave que abrange a organização pai lê a organização vinculada na qual foi criada, a menos que você passe o parâmetro de consulta `organization_id` (o UUID de uma organização vinculada ou seu ID com prefixo `org_`) para [ler uma diferente](https://platform.claude.com/docs/pt-BR/manage-claude/plugins-api#reading-another-organization-under-the-same-parent), e uma chave restrita a uma organização lê apenas essa organização. Essas chamadas contam para os [limites de taxa](https://platform.claude.com/docs/pt-BR/manage-claude/plugins-api#rate-limiting) da Admin API, e não para os da Compliance API.

Criar ou alterar plugins, suas configurações de instalação ou as configurações de um marketplace exige uma chave de Admin API com `write:plugins`. Das chamadas de leitura, apenas o download dos arquivos de um plugin no marketplace pessoal de um membro registra um evento no [Activity Feed](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed) (`claude_plugin_archive_accessed`). Consulte o [guia da API de Plugins](https://platform.claude.com/docs/pt-BR/manage-claude/plugins-api) para cada endpoint, exemplos de requisições e os [eventos que a API registra](https://platform.claude.com/docs/pt-BR/manage-claude/plugins-api#activity-feed-events).

## Próximos passos

<CardGroup cols={2}>
  <Card title="Referência da API de organizações de Compliance" href="https://platform.claude.com/docs/pt-BR/api/compliance/organizations">
    O esquema completo de requisição e resposta para cada endpoint de organização, usuário, função, grupo e configurações.
  </Card>

  <Card title="Tratar erros da Compliance API" href="https://platform.claude.com/docs/pt-BR/manage-claude/compliance-errors">
    Payloads de erro literais e a correção para cada um.
  </Card>
</CardGroup>
