Jobs
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
Jobs do not support sorting.
Query fields
The following fields are required: Project
| Field | Name | Operators |
|---|---|---|
| Kind | kind | = |
| Pipeline | pipeline | = |
| Project | project | = |
| Status | status | = |
| With artifacts | withArtifacts | =, != |
Kind
Description: Filter jobs by their kind.
Allowed value types:
Enum, one ofbridgeorbuild
Notes:
bridgejobs are trigger jobs that start downstream pipelines.buildjobs are regular CI/CD jobs.
Pipeline
Description: Filter jobs by the pipeline they belong to, using the pipeline IID.
Allowed value types: Number (pipeline IID)
Project
Description: Specify the project to query jobs from. This field is required.
Allowed value types: String
Status
Description: Filter jobs by their CI/CD status.
Allowed value types:
Enum, one ofcanceled,canceling,created,failed,manual,pending,preparing,running,scheduled,skipped,success,waiting_for_callback, orwaiting_for_resource
With artifacts
Description: Filter jobs by whether they have artifacts.
Allowed value types: Boolean (either true or false)
Display fields
| Field | Name (and alias) | Description |
|---|---|---|
| Active | active | Display whether the job is active |
| Allow failure | allowFailure | Display whether the job is allowed to fail |
| Cancelable | cancelable | Display whether the job can be canceled |
| Coverage | coverage | Display code coverage percentage |
| Created at | created, createdAt | Display when the job was created |
| Duration | duration | Display the job duration |
| Erased at | erased, erasedAt | Display when job artifacts were erased |
| Failure message | failureMessage | Display the failure message |
| Finished at | finished, finishedAt | Display when the job finished |
| ID | id | Display the job ID |
| Kind | kind | Display the job kind (bridge or build) |
| Manual job | manualJob | Display whether this is a manual job |
| Name | name | Display the job name |
| Playable | playable | Display whether the job can be played |
| Queued at | queued, queuedAt | Display when the job was queued |
| Ref name | refName | Display the Git ref name |
| Retried | retried | Display whether the job was retried |
| Retryable | retryable | Display whether the job can be retried |
| Scheduled | scheduled | Display whether the job is scheduled |
| Scheduling type | schedulingType | Display the scheduling type |
| Short SHA | shortSha | Display the short commit SHA |
| Source | source | Display the job source |
| Stage | stage | Display the pipeline stage the job belongs to |
| Started at | started, startedAt | Display when the job started |
| Status | status | Display the job status |
| Stuck | stuck | Display whether the job is stuck |
| Tags | tags | Display the runner tags |
| Triggered | triggered | Display whether the job was triggered |
| Web path | webPath | Display the web path to the job |
| With artifacts | withArtifacts | Display whether the job has artifacts |