Sign in

v1

latestOpenAPI 3.1.02026-07-22115189303.8 KB
Log Search

Search log events

Search log events for the project associated with your API key. Returns the same event payload shape used by the logs UI. Use POST when sending filters.

get/log_search

Query parameters

querystring

Free-text search query. Blank queries are allowed for browsing narrowed by source, filters, or problems_only.

period'24h' | '7d' | 'context'

Time window to search. Use context with around to fetch nearby events.

source'all' | 'external_api_log' | 'whatsapp_webhook_event' | 'flow_event' | 'webhook_delivery'

Log source to search. Use all to search every source.

problems_onlyboolean

Only return problem or error events.

errors_onlyboolean

Alias for problems_only.

limitinteger

Maximum number of events returned.

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.

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"
      }
    ]
  }
}