Pipelines /
List release flow runs
Required permission
Project > Pipelines > General > Read
Path parameters
projectId
string requiredID of the project
pipelineId
string requiredID of the pipeline
stage
string requiredStage of the pipeline
Query parameters
per_page
integerThe number of results to display per request. Maximum of 100 results per page.
page
integerThe page number to access.
cursor
stringThe cursor returned from the previous page of results, used to request the next page.
Response body
- {object}
Response object.
data
{object} requiredResult data.
runs
[array]A release flow run
- {object}
id
string requiredID of the release flow run
name
stringOptional name for the release flow run
description
stringOptional description for the release flow run
status
string requiredStatus of the template run
one ofpending, running, success, failure, aborted, abortingstartedAt
stringTimestamp the run started at.
concluded
boolean requiredWhether the run has concluded (aborted, success, failed)
concludedAt
stringTimestamp the run concluded at.
createdAt
string requiredTimestamp the run was created at.
updatedAt
string requiredTimestamp the run was last updated at.
pagination
{object} requiredData about the endpoint pagination.
hasNextPage
boolean requiredIs there another page of results available?
cursor
stringThe cursor to access the next page of results.
count
number requiredThe number of results returned by this request.
GET /v1/projects/{projectId}/pipelines/{pipelineId}/release-flows/{stage}/runs
Example response
200 OK
JSON
{
"data": {
"runs": [
{
"id": "110ddb52-bdcd-482d-8ac2-05ba580afe2f",
"name": "Example run",
"description": "This is an example description",
"status": "success",
"startedAt": "2021-01-01 12:01:00.000Z",
"concluded": true,
"concludedAt": "2021-01-01 12:10:00.000Z",
"createdAt": "2021-01-01 12:00:00.000Z",
"updatedAt": "2021-01-01 12:00:00.000Z"
}
]
},
"pagination": {
"hasNextPage": false,
"count": 1
}
}