Sign in
dag-runs

List recent DAG-run artifacts

Returns root DAG-runs that produced artifacts, newest first, each with its files. Child runs are reached through their root.

get/artifacts

Query parameters

remoteNodestring

name of the remote node

workspacestring

Workspace selector. For list and search APIs, use all, default, or a workspace name. Omitted means all.

fromDateinteger

Unix timestamp in seconds

Example:1672531199

start datetime for filtering DAG-runs in ISO 8601 format with timezone

toDateinteger

Unix timestamp in seconds

Example:1672531199

end datetime for filtering DAG-runs in ISO 8601 format with timezone

namestring

Filter by DAG names containing this value

fileNamestring

Select files by path. A value containing glob metacharacters (* ? [ {) is matched as a glob against the path relative to the DAG-run artifact directory; any other value is matched as a case-insensitive substring of that path. A run is returned only if at least one file matches, and only the matching files are listed for it.

limitinteger

Number of runs to return (default 100, max 500)

cursorstring

Opaque cursor returned by the previous artifact list response

Response

A successful response

nextCursorstring

Opaque cursor for the next page; absent when the last page was returned

Example response

{
  "items": [
    {
      "dagRunId": "latest"
    }
  ]
}

Changes

Changed in 1 of the 88 revisions of this API.1