Pipelines /
List preview environments
Required permission
Account > Templates > General > Read
Path parameters
projectId
string requiredID of the project
pipelineId
string requiredID 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.
previewEnvironments
[array] requiredA list of currently available preview environments for the template.
- {object}
id
string requiredIdentifier for the preview template environment
vcsData
{object} requiredData about the version control action that triggered environment creation
repoUrl
string requiredcreatedAt
stringtime of creation
updatedAt
stringtime of update
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}/preview-envs/previews
Example response
200 OK
JSON
{
"data": {
"previewEnvironments": [
{
"id": "clean-step"
}
]
},
"pagination": {
"hasNextPage": false,
"count": 1
}
}