Breaking change deployments on GitLab.com

Changes are deployed continuously to GitLab.com. However, breaking changes can require more time to prepare for.

In the month before the GitLab 18.0 release, breaking changes will be deployed during three time windows. The following tables list when each breaking change will be deployed.

Window 1

This window takes place on April 21 - 23, 2025 from 09:00 UTC to 22:00 UTC.

Deprecation Impact Stage Scope
Registration tokens and server-side runner arguments in POST /api/v4/runners endpoint Critical Verify Instance, group, project
runnerRegistrationToken parameter for GitLab Runner Helm Chart Critical Verify Instance, group, project
Registration tokens and server-side runner arguments in gitlab-runner register command Critical Verify Instance, group, project
Support for REST API endpoints that reset runner registration tokens Critical Verify Instance, group, project
The Project.services GraphQL field is deprecated Low Foundations Instance
Default CI/CD job token (CI_JOB_TOKEN) scope changed High Govern Project
OpenTofu CI/CD template Low Depoy Project
Deprecate CI job implementation of Repository X-Ray Low Create Project

Window 2

This window takes place on April 28 - 30, 2025 from 09:00 UTC to 22:00 UTC.

Deprecation Impact Stage Scope
The heroku/builder:22 image is deprecated Medium Deploy Project
ciUsedMinutes GraphQL field renamed to ciDuration Medium Verify Instance

Window 3

This window takes place on May 5 - 7, 2025 from 09:00 UTC to 22:00 UTC.

Deprecation Impact Stage Scope
ZenTao integration Low Foundations Instance
The ci_job_token_scope_enabled projects API attribute is deprecated Low Govern Project
The direction GraphQL argument for ciJobTokenScopeRemoveProject is deprecated Low Govern Project
ciJobTokenScopeAddProject GraphQL mutation is deprecated Low Govern Project