Search log events with filters - Kapso Documentation

curl --request POST \ --url https://api.kapso.ai/platform/v1/log_search \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <api-key>' \ --data ' { "query": "flow-execution-1", "period": "7d", "source": "flow_event", "filters": { "flow_execution_id": "flow-execution-1", "event_type": "step_failed" } } '

{ "data": { "available": true, "source": "flow_event", "window": { "since": "2026-07-01T12:00:00Z", "until": "2026-07-07T12:00:00Z" }, "events": [ { "id": "evt_2", "source": "flow_event", "timestamp": "2026-07-07T11:58:00Z", "message": "Flow Event step_failed agent_1", "flow_execution_id": "flow-execution-1", "flow_event_id": "flow-event-1", "step_identifier": "agent_1", "step_type": "FlowAgentStep", "error_message": "Tool call failed" } ], "pagination": { "has_more": false, "next_cursor": null } } }

Authorizations

X-API-Key

string

header

required

Body

application/json

query

string

period

enum<string>

default:24h

Available options:

24h,

7d,

context

source

enum<string>

default:all

Available options:

all,

external_api_log,

whatsapp_webhook_event,

flow_event,

webhook_delivery

problems_only

boolean

default:false

errors_only

boolean

default:false

deprecated

Alias for problems_only.

limit

integer

default:50

Required range: 1 <= x <= 100

cursor

string

Cursor returned as pagination.next_cursor from a previous response.

around

string<date-time>

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

highlight_event_id

string

Include this event in the page when available.

highlight_resource_id

string

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

filters

object

object
object[]

Show child attributes

Example:

{ "flow_execution_id": "flow-execution-1" }

Response

Success

data

object

required

Show child attributes