Lista os registros da comunidade (todas as origens)

GET/api/logs

Auth: Exige token
Quem pode:: owner; admin; finance; SuperAdmin
X-CommunityId: X-CommunityId Envie o X-CommunityId da comunidade em que a operação acontece.

Linha do tempo única de tudo o que a comunidade do `X-CommunityId` registra, mais recentes primeiro. Owner e admin leem todos os tipos; o papel **financeiro** lê só o tipo `financial` (pedir outro tipo responde 403 `logs.typeForbidden`; sem `type`, recebe só o financeiro). Moderator e member recebem 403.

Tipos (`type`): - `team`: ações da equipe — mudança de papel, remoção de membro (e saída voluntária), alteração dos dados e das configurações da comunidade, ações sobre assinaturas (cancelar, desconto, cortesia…) e correções de visitas da Presença. - `platform`: histórico da plataforma sobre a comunidade — análise do cadastro da empresa e da conta de recebimento, vendas ligadas ou pausadas, entrada de novos membros suspensa ou retomada, transmissão nativa. - `assistant`: o que um assistente de IA (Claude, ChatGPT, Cursor) fez pela conexão MCP. - `members`: ações de membros que pontuam no ranking. - `emails`: envios de campanhas de e-mail (com contagem de destinatários e entregas). - `imports`: importações de membros que rodaram. - `financial`: vendas, reembolsos e saques como eventos, com o valor bruto. - `moderation`: a última decisão de moderação de cada item (aprovado, recusado, devolvido à fila).

Cada item: `id`, `type`, `action` (chave estável, ex.: `member.role_changed`, `purchase.paid`, `mcp.tool.create_post`), `actor` (`profileId`, `name`, `avatarUrl`, `via`: `app`, `mcp` — feito por um assistente —, `superadmin` ou `system`; `profileId` e `name` nulos quando foi o sistema), `target` (`kind`, `id`, `label`; `spaceId` quando o alvo vive num space; nulo no login diário), `summary` (a frase no idioma do `Accept-Language`), `createdAt` e `details` (só campos seguros: papel antes e depois, status, contagens, valor bruto e moeda).

Nunca aparecem: tokens, argumentos e resultados do MCP, documentos, conta bancária, e-mails, custos do provedor, taxas ou valor líquido.

Filtros: `type`, `actorProfileId` (quem agiu; perfil de outra comunidade não traz nada), `from` e `to` no **fuso da comunidade** (`2026-10-14` é o dia inteiro lá; data e hora sem fuso são hora local da comunidade; com `Z` ou offset, valem como enviadas) e `search` (nome de quem agiu ou do alvo, título, arquivo, campanha, ferramenta). A paginação é exata entre todas as origens.

Parâmetros

Nome	Onde	Tipo	Descrição
`type`opcional	query	`team \| platform \| assistant \| members \| emails \| imports \| financial \| moderation`	Só um tipo. Sem ele, todos os que o papel pode ler.
`actorProfileId`opcional	query	`string (uuid)`	Só o que essa pessoa fez.
`from`opcional	query	`string`	A partir de (inclusive), no fuso da comunidade.
`to`opcional	query	`string`	Até (inclusive), no fuso da comunidade. Uma data inclui o dia todo.
`search`opcional	query	`string`	Texto livre (nome, título, arquivo, campanha, ferramenta).
`page`opcional	query	`integer`
`limit`opcional	query	`integer`

Headers

Nome	Tipo	Descrição
`X-CommunityId`opcional	`string (uuid)`	ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respostas

Código	Descrição
`200`	Lista paginada, mais recentes primeiro.
`400`	Requisição inválida — falha de validação.
`401`	Token ausente, inválido ou expirado.
`403`	Autenticado, mas sem permissão para esta operação.
`500`	Erro interno do servidor.

Exemplo com curl

curl -X GET "https://api.memberfy.net/api/logs" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"