> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Pesquisar eventos de auditoria > Recupere uma lista paginada de eventos de auditoria. Suporta filtragem por tipo de evento, ação, resultado, recurso e intervalo de datas. Os resultados utilizam paginação baseada em cursor. ## OpenAPI ````yaml pt/openapi/v3-current/flowker.yaml get /v1/audit-events openapi: 3.1.0 info: description: >- Referência completa da API para os serviços de orquestração de workflows do Flowker, incluindo gerenciamento de catálogo, definições de workflows, configurações de executores, configurações de provedores e execuções de workflows. title: API do Flowker version: 1.1.1 servers: - url: https://flowker.sandbox.lerian.net security: - ApiKeyAuth: [] tags: - name: Catalog API description: >- Explore provedores, executores e gatilhos integrados disponíveis no catálogo do Flowker. - name: Workflows API description: Crie, atualize, ative, desative, clone e exclua definições de workflows. - name: Executions API description: Inicie execuções de workflows e acompanhe seu status e resultados. - name: Executor Configurations API description: >- Configure, teste e gerencie conexões de executores externos utilizadas pelos nós de workflow. - name: Provider Configurations API description: Configure, teste, habilite e desabilite integrações de provedores. - name: Dashboard API description: >- Recupere resumos agregados de workflows e execuções para dashboards operacionais. - name: Audit API description: >- Consulte e verifique eventos de auditoria para conformidade e visibilidade operacional. - name: Webhooks API description: >- Receba callbacks de webhooks de sistemas externos para disparar execuções de workflows. paths: /v1/audit-events: get: tags: - Audit API summary: Pesquisar eventos de auditoria description: >- Recupere uma lista paginada de eventos de auditoria. Suporta filtragem por tipo de evento, ação, resultado, recurso e intervalo de datas. Os resultados utilizam paginação baseada em cursor. operationId: searchAuditEvents parameters: - description: >- Filtrar por tipo de evento (ex., `WORKFLOW_CREATED`, `EXECUTION_STARTED`). in: query name: eventType schema: type: string - description: >- Filtrar por ação (ex., `CREATE`, `UPDATE`, `DELETE`, `ACTIVATE`, `DEACTIVATE`, `DRAFT`, `EXECUTE`). in: query name: action schema: type: string - description: Filtrar por resultado. in: query name: result schema: enum: - SUCCESS - FAILED type: string - description: Filtrar por tipo de recurso. in: query name: resourceType schema: enum: - workflow - execution - provider_config type: string - description: Filtrar por ID do recurso. in: query name: resourceId schema: format: uuid type: string - description: Início do filtro de intervalo de datas (formato RFC 3339). in: query name: dateFrom schema: format: date-time type: string - description: Fim do filtro de intervalo de datas (formato RFC 3339). in: query name: dateTo schema: format: date-time type: string - description: >- Número máximo de itens por página. O padrão é 20. Deve estar entre 1 e 100. in: query name: limit schema: default: 20 maximum: 100 minimum: 1 type: integer - description: >- Cursor para paginação. Utilize o valor do campo `nextCursor` de uma resposta anterior para recuperar a próxima página. in: query name: cursor schema: type: string - description: >- Direção de ordenação. Utilize `ASC` para ascendente ou `DESC` para descendente. in: query name: sortOrder schema: default: DESC enum: - ASC - DESC type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/AuditEntryListOutput' description: >- Indica que a solicitação foi bem-sucedida e a resposta contém os dados solicitados. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica que a solicitação estava malformada ou continha parâmetros inválidos. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica um erro interno inesperado. Se persistir, entre em contato com o suporte. components: schemas: AuditEntryListOutput: description: Lista paginada de entradas de eventos de auditoria. properties: items: description: Entradas de eventos de auditoria na página atual. items: $ref: '#/components/schemas/AuditEntryOutput' type: array nextCursor: description: Cursor para a próxima página. Vazio se for a última página. example: 9d8e7f6a-5b4c-4321-9876-a1b2c3d4e5f6 type: string hasMore: description: Se há mais páginas disponíveis. example: true type: boolean type: object ErrorResponse: properties: code: description: Código de erro legível por máquina com o prefixo FLK. example: FLK-0001 type: string message: description: Explicação do erro legível por humanos. example: Invalid input provided type: string title: description: Título curto da categoria de erro. example: Bad Request type: string required: - code - message - title type: object AuditEntryOutput: description: >- Registro imutável de evento de auditoria com integridade de cadeia de hashes. properties: eventId: description: Identificador único do evento de auditoria. example: 9d8e7f6a-5b4c-4321-9876-a1b2c3d4e5f6 format: uuid type: string eventType: description: >- Tipo de evento de auditoria (ex., `WORKFLOW_CREATED`, `EXECUTION_STARTED`, `PROVIDER_CONFIG_UPDATED`). example: WORKFLOW_CREATED type: string action: description: >- Ação realizada: `CREATE`, `UPDATE`, `DELETE`, `ACTIVATE`, `DEACTIVATE`, `DRAFT` ou `EXECUTE`. example: CREATE type: string result: description: 'Resultado da ação: `SUCCESS` ou `FAILED`.' example: SUCCESS type: string resourceId: description: Identificador do recurso sobre o qual a ação foi realizada. example: 550e8400-e29b-41d4-a716-446655440000 type: string resourceType: description: 'Tipo de recurso: `workflow`, `execution` ou `provider_config`.' example: workflow type: string actor: $ref: '#/components/schemas/AuditActorOutput' context: additionalProperties: true description: Contexto adicional sobre o evento. type: object metadata: additionalProperties: true description: Metadados adicionais associados ao evento. type: object timestamp: description: Marca temporal de quando o evento ocorreu (RFC 3339). example: '2026-03-17T14:35:15Z' format: date-time type: string hash: description: Hash SHA-256 desta entrada na cadeia de hashes de auditoria. example: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2 type: string previousHash: description: Hash da entrada anterior na cadeia. Vazio para a primeira entrada. example: f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d0c9b8a7f6e5 type: string type: object AuditActorOutput: description: Ator que realizou a ação auditada. properties: type: description: 'Tipo de ator: `user`, `system` ou `api_key`.' example: user type: string id: description: >- Identificador do ator (ID de usuário, nome de serviço ou referência à API key). example: d4e5f6a7-b8c9-4012-d345-444444444444 type: string ipAddress: description: Endereço IP do ator no momento da ação. example: 192.168.1.100 type: string type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Chave de API para autenticar as requisições à API do Flowker. Provisionada por meio da variável de ambiente API_KEY durante o deployment. ````