v1

latestOpenAPI 3.1.02026-07-224239180.9 KB
Job Stage

List job stages

Returns job-stage summaries and resolved settings for the requested stage IDs or a single job. At least one of ids or job_id is required; when both are supplied, only stages that satisfy both are returned. This operation returns a single unpaginated result page.

get/v1/job-stages

Query parameters

cursorstring

Opaque pagination cursor from the previous page's pagination.next_cursor, bound to the same query filters.

Opaque pagination cursor from the previous page's pagination.next_cursor, bound to the same query filters.

limitinteger

Page size. Must be between 1 and 100; defaults to 25.

Page size. Must be between 1 and 100; defaults to 25.

idsstring[] nullable

Comma-separated list of IDs; maximum 100 values.

Comma-separated list of IDs; maximum 100 values.

[
  "stg_a1b2c3d4e5f64789a1b2c3d4e5f64789"
]
job_idstring

a job ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.

Example:job_a1b2c3d4e5f64789a1b2c3d4e5f64789

Matches stages belonging to this exact job ID. When ids is also supplied, results must match both filters.

Response

Success

Example response

{
  "data": [
    {
      "id": "stg_a1b2c3d4e5f64789a1b2c3d4e5f64789",
      "job_id": "job_a1b2c3d4e5f64789a1b2c3d4e5f64789",
      "settings": {
        "automation": {
          "create_automated_task_on_behalf_of": "emp_a1b2c3d4e5f64789a1b2c3d4e5f64789"
        }
      }
    }
  ]
}