Jobs /
List jobs
Required permission
Project > Jobs > General > Read
Path parameters
projectId
string requiredID of the project
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.
jobs
[array] requiredAn array of job objects.
- {object}
id
string requiredIdentifier for the job
projectId
string requiredID of the project that the job belongs to
appId
string requiredFull identifier used for job deployment
name
string requiredJob name
description
stringA short description of the job
jobType
string requiredType of the job (manual or cron)
one ofmanual, crondisabledCI
boolean requiredWhether Continuous Integration is disabled
disabledCD
boolean requiredWhether Continuous Deployment is disabled
suspended
booleanCron specific. Whether or not the job's automatic scheduling is suspended
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}/jobs
Example response
200 OK
JSON
{
"data": {
"jobs": [
{
"id": "example-job",
"projectId": "default-project",
"appId": "/example-user/default-project/example-job",
"name": "Example Job",
"tags": [
"my-tag"
],
"description": "This is the job description",
"jobType": "cron",
"disabledCI": false,
"disabledCD": false,
"suspended": false
}
]
},
"pagination": {
"hasNextPage": false,
"count": 1
}
}