List pipelines

Lists the pipelines visible to the caller in the current workspace (every environment the pipeline references must be visible), with ordinary offset-based paging.

Last updated:

Lists the pipelines visible to the caller in the current workspace (every environment the pipeline references must be visible), with ordinary offset-based paging.

GET /api/v1/pipelines

Authorization

Requires a signed-in person with this scope: pipelines:read.

Parameters

NameInRequiredTypeDescription
X-Workspace-Idheaderyesstring (uuid)The workspace the call acts in. Take it from the workspace list.
statusquerynoone of DRAFT, VALID, INVALIDKeep only pipelines with this validation status.
searchquerynostringKeep only pipelines whose name contains this text (case-insensitive).
pagequerynointegerThe page number, starting at 0.
sizequerynointegerThe page size (default 20, capped at 100).
sortquerynostringSort field and direction, for example "updatedAt,desc".

Responses

200

The pipelines.

FieldTypeRequiredDescription
contentlist of objectyes
content[].idstring (uuid)yes
content[].namestringyes
content[].statusone of DRAFT, VALID, INVALIDyes
content[].statusReasonstringno
content[].schedulestringyes
content[].actionCountintegeryes
content[].updatedAtstring (date-time)yes
pageintegeryes
sizeintegeryes
totalElementsintegeryes
totalPagesintegeryes

Example response:

{
  "content": [
    {
      "id": "3a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
      "name": "Nightly customer sync",
      "status": "VALID",
      "schedule": "0 2 * * *",
      "actionCount": 2,
      "updatedAt": "2026-10-01T02:00:00Z"
    }
  ],
  "page": 0,
  "size": 20,
  "totalElements": 1,
  "totalPages": 1
}

400

A query value is of the wrong kind (for example a page number that is not a number); the message names the parameter.

FieldTypeRequiredDescription
messagestringyes
statusintegeryes
errorCodestringyes
timestampstring (date-time)no
pathstringno
detailsobjectno