> ## 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. # Buscar eventos de auditoría > Recupere una lista paginada de eventos de auditoría. Soporta filtrado por tipo de evento, acción, resultado, recurso y rango de fechas. Los resultados utilizan paginación basada en cursor. ## OpenAPI ````yaml es/openapi/v3-current/flowker.yaml get /v1/audit-events openapi: 3.1.0 info: description: >- Referencia completa de la API para los servicios de orquestación de workflows de Flowker, incluyendo gestión de catálogo, definiciones de workflows, configuraciones de ejecutores, configuraciones de proveedores y ejecuciones de workflows. title: API de Flowker version: 1.1.1 servers: - url: https://flowker.sandbox.lerian.net security: - ApiKeyAuth: [] tags: - name: Catalog API description: >- Explore proveedores, ejecutores y disparadores integrados disponibles en el catálogo de Flowker. - name: Workflows API description: >- Cree, actualice, active, desactive, clone y elimine definiciones de workflows. - name: Executions API description: Inicie ejecuciones de workflows y rastree su estado y resultados. - name: Executor Configurations API description: >- Configure, pruebe y administre conexiones de ejecutores externos utilizadas por los nodos de workflow. - name: Provider Configurations API description: Configure, pruebe, habilite y deshabilite integraciones de proveedores. - name: Dashboard API description: >- Recupere resúmenes agregados de workflows y ejecuciones para dashboards operacionales. - name: Audit API description: >- Consulte y verifique eventos de auditoría para cumplimiento y visibilidad operacional. - name: Webhooks API description: >- Reciba callbacks de webhooks desde sistemas externos para disparar ejecuciones de workflows. paths: /v1/audit-events: get: tags: - Audit API summary: Buscar eventos de auditoría description: >- Recupere una lista paginada de eventos de auditoría. Soporta filtrado por tipo de evento, acción, resultado, recurso y rango de fechas. Los resultados utilizan paginación basada en cursor. operationId: searchAuditEvents parameters: - description: >- Filtrar por tipo de evento (ej., `WORKFLOW_CREATED`, `EXECUTION_STARTED`). in: query name: eventType schema: type: string - description: >- Filtrar por acción (ej., `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 del recurso. in: query name: resourceId schema: format: uuid type: string - description: Inicio del filtro de rango de fechas (formato RFC 3339). in: query name: dateFrom schema: format: date-time type: string - description: Fin del filtro de rango de fechas (formato RFC 3339). in: query name: dateTo schema: format: date-time type: string - description: >- Número máximo de elementos por página. Por defecto es 20. Debe estar entre 1 y 100. in: query name: limit schema: default: 20 maximum: 100 minimum: 1 type: integer - description: >- Cursor para paginación. Utilice el valor del campo `nextCursor` de una respuesta anterior para recuperar la siguiente página. in: query name: cursor schema: type: string - description: >- Dirección de ordenamiento. Utilice `ASC` para ascendente o `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 la solicitud fue exitosa y la respuesta contiene los datos solicitados. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica que la solicitud estaba mal formada o contenía parámetros no válidos. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Indica un error interno inesperado. Si persiste, contacte al soporte. components: schemas: AuditEntryListOutput: description: Lista paginada de entradas de eventos de auditoría. properties: items: description: Entradas de eventos de auditoría en la página actual. items: $ref: '#/components/schemas/AuditEntryOutput' type: array nextCursor: description: Cursor para la siguiente página. Vacío si es la última página. example: 9d8e7f6a-5b4c-4321-9876-a1b2c3d4e5f6 type: string hasMore: description: Si hay más páginas disponibles. example: true type: boolean type: object ErrorResponse: properties: code: description: Código de error legible por máquina con el prefijo FLK. example: FLK-0001 type: string message: description: Explicación del error legible por humanos. example: Invalid input provided type: string title: description: Título corto de categoría de error. example: Bad Request type: string required: - code - message - title type: object AuditEntryOutput: description: >- Registro inmutable de evento de auditoría con integridad de cadena de hashes. properties: eventId: description: Identificador único del evento de auditoría. example: 9d8e7f6a-5b4c-4321-9876-a1b2c3d4e5f6 format: uuid type: string eventType: description: >- Tipo de evento de auditoría (ej., `WORKFLOW_CREATED`, `EXECUTION_STARTED`, `PROVIDER_CONFIG_UPDATED`). example: WORKFLOW_CREATED type: string action: description: >- Acción realizada: `CREATE`, `UPDATE`, `DELETE`, `ACTIVATE`, `DEACTIVATE`, `DRAFT` o `EXECUTE`. example: CREATE type: string result: description: 'Resultado de la acción: `SUCCESS` o `FAILED`.' example: SUCCESS type: string resourceId: description: Identificador del recurso sobre el que se actuó. example: 550e8400-e29b-41d4-a716-446655440000 type: string resourceType: description: 'Tipo de recurso: `workflow`, `execution` o `provider_config`.' example: workflow type: string actor: $ref: '#/components/schemas/AuditActorOutput' context: additionalProperties: true description: Contexto adicional sobre el evento. type: object metadata: additionalProperties: true description: Metadatos adicionales asociados al evento. type: object timestamp: description: Marca de tiempo de cuando ocurrió el evento (RFC 3339). example: '2026-03-17T14:35:15Z' format: date-time type: string hash: description: Hash SHA-256 de esta entrada en la cadena de hashes de auditoría. example: a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2 type: string previousHash: description: >- Hash de la entrada anterior en la cadena. Vacío para la primera entrada. example: f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f2e1d0c9b8a7f6e5 type: string type: object AuditActorOutput: description: Actor que realizó la acción auditada. properties: type: description: 'Tipo de actor: `user`, `system` o `api_key`.' example: user type: string id: description: >- Identificador del actor (ID de usuario, nombre de servicio o referencia a API key). example: d4e5f6a7-b8c9-4012-d345-444444444444 type: string ipAddress: description: Dirección IP del actor en el momento de la acción. example: 192.168.1.100 type: string type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Clave de API para autenticar las solicitudes a la API de Flowker. Se aprovisiona mediante la variable de entorno API_KEY durante el despliegue. ````