v5

latestOpenAPI 3.1.02026-08-081,0211,3082.1 MB
QUERIES_V2

Get Task Runs

Individual runs of one Snowflake task (the drill-down opened when a task name is clicked), read from snowflake_task_history and filtered to the qualified (database_name, schema_name, name) triple. Summed metrics live on /tasks/list; this returns one row per run with derived per-run durations.

The optional repeatable states query param narrows the per-run table to the given run states (e.g. ?states=FAILED&states=EXECUTING); absent or empty means "all states".

get/query/v2/tasks/runs

Query parameters

database_namestring required
schema_namestring required
namestring required
pageinteger

Page number

Page number

sizeinteger

Page size

Page size

sortAttributestring nullable
sortOrderstring nullable
start_datestring date-time nullable
end_datestring date-time nullable
statesstring[] nullable
navigationSourcestring nullable

Headers

x-tenantstring required

Response

Successful Response

totalinteger nullable required
pageinteger nullable required
sizeinteger nullable required
pagesinteger nullable