v1

latestOpenAPI 3.1.02026-07-22115189303.8 KB
Log Search

Search log events with filters

Search log events with the same project-scoped data and filter catalog used by the logs UI.

post/log_search

Request body

querystring
period'24h' | '7d' | 'context'
source'all' | 'external_api_log' | 'whatsapp_webhook_event' | 'flow_event' | 'webhook_delivery'
problems_onlyboolean
errors_onlyboolean

Alias for problems_only.

limitinteger
cursorstring

Cursor returned as pagination.next_cursor from a previous response.

aroundstring date-time

Center a context search around this timestamp. Use with period=context.

highlight_event_idstring

Include this event in the page when available.

highlight_resource_idstring

Include an event for this resource in the page when available.

Example request

{
  "filters": [
    {
      "key": "flow_execution_id"
    }
  ]
}

Response

Success

Example response

{
  "data": {
    "events": [
      {
        "id": "evt_1",
        "source": "external_api_log",
        "level": "info",
        "status": "failed",
        "message": "POST /v1/messages",
        "resource_type": "external_api_log",
        "http_method": "POST",
        "endpoint": "/v1/messages",
        "api_key_name": "Production key",
        "response_status": 422,
        "event_type": "agent_iteration_started",
        "flow_name": "Support workflow",
        "step_identifier": "agent_1"
      }
    ]
  }
}