TaskRuns

List task runs

Returns a list of task run records for the current account, ordered by most recent first. Supports filtering by status, task_id and created_after. To find runs that went wrong across every task, make one call without task_id, e.g. status=failed,timed_out&created_after=<last check>, rather than one call per task. The same one call with only created_after (e.g. the start of today in the user's timezone) answers what ran today: each run names its task in task_name.

get/task_runs

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/task_runs
  • Auth: API key in header Authorization

Query parameters

statusstring

Filter by run status: one of pending, running, completed, failed, needs_input, timed_out, unknown, skipped, or a comma-separated list of them (e.g. failed,timed_out)

trigger_sourcestring

Filter by what started the run: scheduled, event or manual, or a comma-separated list. event lists the events a task received; each run carries its trigger_event.

created_afterstring date-time

Only runs created at or after this ISO 8601 timestamp

task_idstring

Filter by the parent task's prefixed ID

starting_afterstring

Cursor for pagination — the ID of the last item in the previous page

limitinteger

Items per page

Response

List of task runs

object'list' required
has_moreboolean required
urlstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.