Logs

lo

The Logs block gives agents programmatic access to workflow run history in the current workspace. It queries the same run data shown on the Logs page and can fetch full execution detail for any individual run.

With Logs, you can:

  • Query run history: Filter runs by workflow, folder, status, trigger type, date range, cost, and duration, with sorting and free-text search
  • Fetch run details: Retrieve a specific run's status, trigger, timing, cost, and final output by run ID
  • Inspect execution traces: Pull the full trace spans for a run to see how it executed step by step

In Zoen, the Logs block allows your agents to search and filter workflow run history using the same filters available on the Logs page, then drill into a specific run to retrieve its status, cost, duration, final output, and full trace spans. This lets agents monitor other workflows, audit past executions, and pull execution details programmatically as part of a larger workflow.

Usage Instructions

Query workflow run logs in the current workspace with the same filters as the Logs page, returning matching run IDs. Fetch full details for a single run, including its trace spans.

Actions

logs_query_runs

Query workflow run logs in the current workspace with the full Logs-page filter set. Returns matching run IDs.

Input

ParameterTypeRequiredDescription
workflowIdsstringNoComma-separated workflow IDs to filter by
folderIdsstringNoComma-separated folder IDs to filter by (descendants included)
levelstringNoComma-separated statuses: 'info', 'error', 'running', 'pending', 'cancelled'. Omit for all.
triggersstringNoComma-separated trigger types (api, webhook, schedule, manual, chat, mcp, workflow, sim, …)
startDatestringNoISO 8601 timestamp; only runs at or after this time
endDatestringNoISO 8601 timestamp; only runs at or before this time
searchstringNoFree-text search across log fields
costOperatorstringNoCost comparison operator: '=', '>', '<', '>=', '<=', '!='
costValuenumberNoCost threshold in credits, compared using costOperator
durationOperatorstringNoDuration comparison operator: '=', '>', '<', '>=', '<=', '!='
durationValuenumberNoDuration threshold in milliseconds, compared using durationOperator
limitnumberNoMax run IDs to return (default 100, max 200)
sortBystringNoSort field: 'date' (default), 'duration', 'cost', 'status'
sortOrderstringNoSort order: 'desc' (default) or 'asc'

Output

ParameterTypeDescription
runIdsarrayIDs of the runs matching the filters

logs_get_run_details

Fetch details for a single workflow run by its run ID, including the full trace spans.

Input

ParameterTypeRequiredDescription
runIdstringYesThe run ID to fetch details for

Output

ParameterTypeDescription
runIdstringThe run ID
workflowIdstringWorkflow ID this run belongs to
workflowNamestringWorkflow name
statusstringRun status
triggerstringHow the run was triggered
startedAtstringRun start time (ISO 8601)
durationMsnumberRun duration in milliseconds
costnumberRun cost in credits
traceSpansarrayFull trace spans for the run
finalOutputjsonFinal output of the run

On this page