Query Logs
List workflow execution logs with advanced filtering and cursor-based pagination. Supports filtering by workflow, trigger type, date range, duration, cost, and more.
Query parameters
The unique identifier of the workspace.
Comma-separated list of workflow IDs to filter by. Only logs from these workflows will be returned.
Comma-separated list of folder IDs. Returns logs for all workflows within these folders.
Comma-separated trigger types to filter by: api, webhook, schedule, manual, chat.
Filter logs by severity level. info for successful executions, error for failed ones.
Only return logs after this ISO 8601 timestamp (inclusive).
Only return logs before this ISO 8601 timestamp (inclusive).
Filter by an exact execution ID. Useful for looking up a specific run.
Only return logs where execution took at least this many milliseconds.
Only return logs where execution took at most this many milliseconds.
Only return logs where execution cost at least this amount in USD.
Only return logs where execution cost at most this amount in USD.
Filter by the AI model used during execution (e.g., gpt-4o, claude-sonnet-4-20250514).
Response detail level. basic returns summary fields only. full includes execution data, trace spans, and outputs.
When true, includes block-level execution trace spans with timing and input/output data.
When true, includes the workflow's final output in each log entry.
Maximum number of log entries to return per page.
Pagination cursor returned from a previous request's nextCursor field.
Sort order by execution start time. desc returns newest first.
Response
A paginated list of execution logs matching the filter criteria.
Example response
{
"data": [
{
"id": "log_7x8y9z0a1b",
"workflowId": "3b1f7c92-8d4e-4a6b-9c0d-5e2f8a714b36",
"executionId": "e4f8d2b6-9a1c-4e3d-8b7f-5c0a2d9e6f13",
"level": "info",
"trigger": "api",
"startedAt": "2025-06-20T14:15:22Z",
"endedAt": "2025-06-20T14:15:23Z",
"totalDurationMs": 1250,
"cost": {
"total": 0.0032
}
}
],
"limits": {
"workflowExecutionRateLimit": {
"sync": {
"requestsPerMinute": 60,
"maxBurst": 10,
"remaining": 59,
"resetAt": "2025-06-20T14:16:00Z"
},
"async": {
"requestsPerMinute": 60,
"maxBurst": 10,
"remaining": 59,
"resetAt": "2025-06-20T14:16:00Z"
}
},
"usage": {
"currentPeriodCost": 1.25,
"limit": 50,
"plan": "pro"
}
}
}