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
| Name | In | Required | Type | Description |
|---|---|---|---|---|
X-Workspace-Id | header | yes | string (uuid) | The workspace the call acts in. Take it from the workspace list. |
status | query | no | one of DRAFT, VALID, INVALID | Keep only pipelines with this validation status. |
search | query | no | string | Keep only pipelines whose name contains this text (case-insensitive). |
page | query | no | integer | The page number, starting at 0. |
size | query | no | integer | The page size (default 20, capped at 100). |
sort | query | no | string | Sort field and direction, for example "updatedAt,desc". |
Responses
200
The pipelines.
| Field | Type | Required | Description |
|---|---|---|---|
content | list of object | yes | |
content[].id | string (uuid) | yes | |
content[].name | string | yes | |
content[].status | one of DRAFT, VALID, INVALID | yes | |
content[].statusReason | string | no | |
content[].schedule | string | yes | |
content[].actionCount | integer | yes | |
content[].updatedAt | string (date-time) | yes | |
page | integer | yes | |
size | integer | yes | |
totalElements | integer | yes | |
totalPages | integer | yes |
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.
| Field | Type | Required | Description |
|---|---|---|---|
message | string | yes | |
status | integer | yes | |
errorCode | string | yes | |
timestamp | string (date-time) | no | |
path | string | no | |
details | object | no |