--- title: Consultar o Activity Feed url: https://platform.claude.com/docs/pt-BR/manage-claude/compliance-activity-feed description: Recupere, filtre e pagine o Activity Feed da Compliance API da sua organização. --- Para habilitar a Compliance API, consulte [Configurar a Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access). **Escopo necessário:** `read:compliance_activities` na Compliance Access Key ou na chave de API de Admin. Tanto as Compliance Access Keys (`sk-ant-api01-...`) que possuem esse escopo quanto as chaves de API de Admin (`sk-ant-admin01-...`) podem chamar o Activity Feed. Consulte [Configurar a Compliance API](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-api-access) para ver as condições sob as quais cada tipo de chave possui o escopo. O Activity Feed registra atividades de autenticação, chat, arquivos, projetos, administrativas e da plataforma em toda a sua organização e as retorna em ordem cronológica inversa. As atividades podem ser consultadas em até 1 minuto após ocorrerem e são retidas por 6 anos. O registro não é retroativo: ele começa quando a Compliance API é habilitada pela primeira vez para a sua organização, e as atividades anteriores à habilitação não são preenchidas retroativamente. ```bash cURL curl --fail-with-body -sS \ "https://api.anthropic.com/v1/compliance/activities?limit=1" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" ``` ```json Response { "data": [ { "id": "activity_01XyDMpzjS89pFZXqSFUBDr6", "created_at": "2026-04-10T08:09:10Z", "organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8", "organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789", "actor": { "type": "user_actor", "email_address": "user@example.com", "user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4", "ip_address": "192.0.2.34", "user_agent": "Mozilla/5.0..." }, "type": "claude_chat_created", "claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6", "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq" } ], "has_more": true, "first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6", "last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6" } ``` ## Filtrar atividades Filtre por organização, ator, tipo de atividade ou por uma janela de tempo de `created_at` usando os subparâmetros com ponto `created_at.gte`, `.gt`, `.lte` e `.lt`. Consulte a [referência da API](https://platform.claude.com/docs/pt-BR/api/compliance/activities/list) para ver o tipo e os valores aceitos de cada parâmetro. Parâmetros repetíveis usam a sintaxe de consulta com colchetes de array: passe `activity_types[]=...`, `actor_ids[]=...` ou `organization_ids[]=...` uma vez para cada valor. ```bash cURL curl --fail-with-body -sS -G \ "https://api.anthropic.com/v1/compliance/activities" \ --data-urlencode "activity_types[]=claude_file_uploaded" \ --data-urlencode "activity_types[]=claude_chat_created" \ --data-urlencode "created_at.gte=2026-04-01T00:00:00Z" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" ``` O Activity Feed produz centenas de tipos de atividade distintos. Consulte [Consultar atividades de conformidade](https://platform.claude.com/docs/pt-BR/api/compliance/activities/list) na referência da API para ver a lista completa de valores que `activity_types[]` aceita. ## Paginar resultados As atividades são retornadas das mais recentes para as mais antigas, com empates em `created_at` desempatados pelo ID da atividade, e limitadas a `limit` resultados em cada resposta (padrão 100, máximo 5.000). Consulte a [referência da API](https://platform.claude.com/docs/pt-BR/api/compliance/activities/list) para ver o esquema completo da resposta. A Compliance API usa dois esquemas de "pagination" (paginação), dependendo da família de endpoints: | Família de endpoints | Ordem de classificação | Esquema | Parâmetros | | --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | --------------- | --------------------------------------------------------------- | | Atividades | Mais recentes primeiro | Cursor | `after_id`, `before_id` (retornados como `first_id`, `last_id`) | | Chats e mensagens de chat | Mais antigos primeiro | Cursor | `after_id`, `before_id` (retornados como `first_id`, `last_id`) | | Organizações, projetos, anexos de projetos, usuários, funções, permissões de funções, grupos, membros de grupos | Específica do endpoint | Token de página | `page` (retornado como `next_page`) | | Sessões locais e remotas e mensagens de sessão | Sessões mais recentes primeiro; mensagens mais antigas primeiro por padrão | Token de página | `page` (retornado como `next_page`) | Arquivos não são paginados: eles são recuperados individualmente por ID. Cursores de paginação e tokens de página são strings opacas: passe-os de volta sem alterações. Seu formato interno não é estável, e analisá-los deixará de funcionar sem aviso prévio. Apenas um entre `after_id` ou `before_id` pode ser definido em cada requisição, e ambos os esquemas retornam `has_more` para que você saiba quando parar. Os endpoints de sessão (locais e remotos) são a exceção: eles retornam `next_page` sem `has_more`, então pare quando `next_page` for `null`. Para percorrer as páginas de atividades: * Passe o `last_id` da resposta como `after_id` para avançar para a próxima página na ordem dos resultados. Com as atividades ordenadas das mais recentes para as mais antigas, a próxima página contém entradas mais antigas. * Passe `first_id` como `before_id` para retornar à página anterior. * Pare quando `has_more` for `false`. O parâmetro de cursor define a direção da página; a ordem de classificação do endpoint define a direção no tempo. O mesmo parâmetro `after_id` alcança atividades mais antigas aqui. Os chats são ordenados dos mais antigos para os mais recentes; consulte [Recuperar e excluir chats, arquivos e projetos](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-content-data) para ver a semântica do cursor nesse caso. **Cursores podem ser reutilizados com segurança em novas tentativas.** Um cursor ou token de página de uma página retornada com sucesso permanece válido; uma requisição que falha (5xx, timeout, erro de rede) não avança sua posição. Repita a mesma requisição com o mesmo cursor. Só passe para o próximo cursor depois de ter armazenado a página que ele ultrapassa. Os tokens de página nos endpoints de sessões locais são a exceção em pausas mais longas. No [endpoint de mensagens de sessões locais](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-sessions#retrieve-a-local-session-transcript), os tokens `page` de uma varredura expiram 24 horas após sua primeira página (uma varredura é uma passagem pelas páginas), então conclua ou retome dentro dessa janela, ou reinicie sem o parâmetro `page`. Na [lista de sessões locais](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-sessions#retrieve-local-sessions), um token `page` mais antigo ainda é aceito, mas é reavaliado em relação ao limite de retenção atual e pode pular sessões, então conclua também as varreduras da lista em até 24 horas. ```bash cURL # Busca a primeira página (atividades mais recentes primeiro) e captura o cursor final dela. last_id=$(curl --fail-with-body -sS \ "https://api.anthropic.com/v1/compliance/activities?limit=2" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" | jq -er '.last_id') # Passe o cursor de volta sem alterações para buscar a próxima página (mais antiga). curl --fail-with-body -sS -G \ "https://api.anthropic.com/v1/compliance/activities" \ --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \ --header "anthropic-version: 2023-06-01" \ --data-urlencode "limit=2" \ --data-urlencode "after_id=${last_id}" ``` Um loop de **backfill** (preenchimento retroativo) em produção percorre as páginas de atividades mais antigas conduzindo a iteração com base em `has_more` e `last_id`: 1. Comece a partir do seu cursor armazenado (ou omita `after_id` para começar do início). 2. Percorra as páginas com `after_id=` até que `has_more` seja `false`. 3. Persista o `last_id` final somente depois de ter armazenado todas as páginas que ele abrange. ```text cursor = stored_cursor loop: if cursor is not null: page = GET /v1/compliance/activities?after_id={cursor}&limit=100 else: page = GET /v1/compliance/activities?limit=100 store(page.data) if page.last_id is not null: cursor = page.last_id if not page.has_more: break persist(cursor) ``` ## Entender o objeto Activity Cada entrada em `data` é uma Activity com esta estrutura de nível superior: | Campo | Tipo | Descrição | | ------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | Identificador único da atividade. | | `created_at` | string RFC 3339 | Quando a atividade ocorreu. | | `organization_id` | string ou null | Organização onde a atividade ocorreu, ou `null` para eventos não vinculados a uma organização (login, logout, chamadas à Compliance API). | | `organization_uuid` | string ou null | Mesmo escopo de `organization_id`, expresso como um UUID. | | `actor` | União Actor | Quem ou o que realizou a atividade. Consulte a tabela de atores a seguir. | | `type` | string | O tipo de atividade, por exemplo `claude_chat_created`. | | *campos adicionais* | varia | Campos específicos do tipo, por exemplo `claude_chat_id` em eventos de chat ou `claude_file_id` em eventos de arquivo. Consulte [Consultar atividades de conformidade](https://platform.claude.com/docs/pt-BR/api/compliance/activities/list) na referência da API para ver a lista de campos por tipo. | O campo `actor` é uma "discriminated union" (união discriminada). O discriminador `type` indica quais outros campos estão presentes: | `actor.type` | Quando aparece | Campos principais | | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `user_actor` | Um usuário conectado do claude.ai ou do Claude Console realizou a ação, ou um processo que a Anthropic executa em nome desse usuário a realizou (consulte o parágrafo após esta tabela). | `email_address`, `user_id`, `ip_address`, `user_agent` | | `api_actor` | Uma requisição chamou a Claude API ou a Compliance API com uma chave de API emitida pelo cliente. Chamadas à Compliance API produzem esse tipo de ator tanto para Compliance Access Keys quanto para chaves de API de Admin. | `api_key_id`, `ip_address`, `user_agent` | | `admin_api_key_actor` | Um administrador da organização usou uma chave de API de Admin para gerenciar usuários, convites, workspaces ou chaves de API. | `admin_api_key_id`, `ip_address`, `user_agent` | | `unauthenticated_user_actor` | Uma ação ocorreu antes da conclusão do login, por exemplo `sso_login_initiated`. | `unauthenticated_email_address`, `ip_address`, `user_agent` | | `anthropic_actor` | A Anthropic agiu sobre a organização, por exemplo por meio de ferramentas internas. | `email_address` (sempre `null`; presente para manter a consistência de estrutura com `user_actor`, porque os operadores da Anthropic não são representados por e-mail individual) | | `system_actor` | Processamento automatizado em segundo plano realizado por sistemas da Anthropic, agindo sem uma credencial de usuário ou de cliente. | `service` (anulável; o nome do processo automatizado que realizou a ação, quando conhecido) | | `scim_directory_sync_actor` | Um provedor de identidade (como Okta, Microsoft Entra ID ou JumpCloud) enviou uma alteração por meio da sincronização de diretório SCIM. | `workos_event_id`, `directory_id`, `idp_connection_type` (anulável; por exemplo `OktaSCIMV2`, `AzureSCIMV2`) | Uma atividade `user_actor` nem sempre significa que o usuário realizou a ação. Processos que a Anthropic executa em nome de um usuário podem atualmente aparecer como `user_actor` para o usuário afetado, em vez de `system_actor`, e essa atribuição pode mudar. Por exemplo, atividades de memória provenientes de uma migração, como `platform_memory_store_created`, `platform_memory_created` e `platform_memory_deleted`, são atribuídas dessa forma. Atividades de memória podem mostrar um `ip_address` de `0.0.0.0` independentemente de quem as realizou, portanto esse valor, por si só, não identifica atividades de um processo da plataforma. Uma atividade `claude_*_viewed` significa que um aplicativo Claude carregou conteúdo, não que uma pessoa o visualizou. Tipos como `claude_chat_viewed`, `claude_file_viewed` e `claude_project_viewed` são registrados sempre que um aplicativo Claude carrega o chat, arquivo ou projeto dos servidores da Anthropic. Carregamentos repetidos não são desduplicados. Os aplicativos web, desktop e mobile carregam conteúdo em momentos diferentes, às vezes em segundo plano, e podem exibir uma cópia em cache sem carregá-la. Como resultado, as contagens dessas atividades variam de acordo com a plataforma e não correspondem a mensagens enviadas ou telas visualizadas. Atividades relacionadas a um arquivo, documento de projeto ou artefato não incluem seu nome ou título. A partir de 24 de setembro de 2026, os campos `filename` e `title` nessas atividades são sempre `null`, uma string vazia ou omitidos, inclusive em atividades registradas antes dessa data. Para consultar um nome ou título, passe o ID `claude_file_*`, `claude_proj_doc_*` ou `claude_artifact_version_*` da atividade para o endpoint de metadados correspondente em [Recuperar arquivos e artefatos](https://platform.claude.com/docs/pt-BR/manage-claude/compliance-content-data#retrieve-files-and-artifacts), usando uma Compliance Access Key com o escopo `read:compliance_user_data`. Não é possível consultar um nome ou título depois que o arquivo, documento ou artefato é excluído, ou quando a atividade não possui esse ID. **Crie handlers compatíveis com versões futuras.** Repasse valores de `type` e `actor.type` não reconhecidos e ignore campos que seu handler não espera, para que sua integração continue funcionando quando novos tipos de atividade forem lançados. ## Próximos passos O esquema completo de requisição e resposta para `GET /v1/compliance/activities`, incluindo todos os valores de `activity_types[]` suportados. Consulte e exclua o conteúdo subjacente das atividades que você encontrar no feed (Compliance Access Key necessária). Escolha um padrão de consumo por polling ou em lote e planeje a correlação com SIEM. O catálogo completo de erros.