{"slug":"gitlab-api","name":"GitLab API","host":"gitlab.com","site":"https://gitlab.com","category":"devtools","docsUrl":null,"sources":[{"kind":"changelog","url":"https://docs.gitlab.com/releases/breaking-changes.xml"},{"kind":"openapi","url":"https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/openapi/openapi_v3.yaml"},{"kind":"archive","url":"https://docs.gitlab.com/api/rest/deprecations/"},{"kind":"archive","url":"https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/update/deprecations.md"}],"url":"https://www.okapi.bot/providers/gitlab-api/","json":"https://www.okapi.bot/api/v1/providers/gitlab-api.json","breakingChanges":[{"slug":"api-v4-projects-managed-licenses-stops-working","api":"gitlab-api","title":"/api/v4/projects/{}/managed_licenses stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2023-02-22","effectiveAt":"2023-05-22","scope":null,"calls":["/api/v4/projects/{}/managed_licenses*"],"method":null,"path":"/api/v4/projects/{}/managed_licenses*","source":{"url":"https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/update/deprecations.md","kind":"archive"},"quote":"The Managed Licenses API is now deprecated and is scheduled for removal in GitLab 16.0.","migration":"Enforce license approvals with a License Approval policy (security policies) instead.","migrationChange":null,"needsDecision":"No REST endpoint replaces it: license approvals move to License Approval policies.","text":null,"publishedAt":"2026-10-23T09:56:46.455Z","updatedAt":"2026-10-23T09:56:46.455Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/gitlab-api/breaking-changes/api-v4-projects-managed-licenses-stops-working/"},{"slug":"environment-tier-on-get-api-v4-groups-dora-metrics-stops-working","api":"gitlab-api","title":"environment_tier on GET /api/v4/groups/{}/dora/metrics stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2023-01-22","effectiveAt":"2023-05-22","scope":null,"calls":["GET /api/v4/groups/{}/dora/metrics","query parameter environment_tier"],"method":"GET","path":"/api/v4/groups/{}/dora/metrics","source":{"url":"https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/update/deprecations.md","kind":"archive"},"quote":"To avoid confusion and duplication, the `environment_tier` parameter is deprecated in favor of the `environment_tiers` parameter.","migration":"Send environment_tiers (an array) instead of environment_tier.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:56:46.455Z","updatedAt":"2026-10-23T09:56:46.455Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/gitlab-api/breaking-changes/environment-tier-on-get-api-v4-groups-dora-metrics-stops-working/"},{"slug":"environment-tier-on-get-api-v4-projects-dora-metrics-stops-working","api":"gitlab-api","title":"environment_tier on GET /api/v4/projects/{}/dora/metrics stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2023-01-22","effectiveAt":"2023-05-22","scope":null,"calls":["GET /api/v4/projects/{}/dora/metrics","query parameter environment_tier"],"method":"GET","path":"/api/v4/projects/{}/dora/metrics","source":{"url":"https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/update/deprecations.md","kind":"archive"},"quote":"To avoid confusion and duplication, the `environment_tier` parameter is deprecated in favor of the `environment_tiers` parameter.","migration":"Send environment_tiers (an array) instead of environment_tier.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:56:46.455Z","updatedAt":"2026-10-23T09:56:46.455Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/gitlab-api/breaking-changes/environment-tier-on-get-api-v4-projects-dora-metrics-stops-working/"},{"slug":"post-api-v4-ci-lint-stops-working","api":"gitlab-api","title":"POST /api/v4/ci/lint stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2022-12-22","effectiveAt":"2023-05-22","scope":null,"calls":["POST /api/v4/ci/lint"],"method":"POST","path":"/api/v4/ci/lint","source":{"url":"https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/update/deprecations.md","kind":"archive"},"quote":"The `POST ci/lint` API endpoint is deprecated in 15.7, and will be removed in 16.0.","migration":"Validate CI/CD configuration with POST /api/v4/projects/{id}/ci/lint instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:56:46.455Z","updatedAt":"2026-10-23T09:56:46.455Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/gitlab-api/breaking-changes/post-api-v4-ci-lint-stops-working/"},{"slug":"post-api-v4-projects-merge-requests-approvals-stops-working","api":"gitlab-api","title":"POST /api/v4/projects/{}/merge_requests/{}/approvals stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":"2021-06-22","effectiveAt":"2023-05-22","scope":null,"calls":["POST /api/v4/projects/{}/merge_requests/{}/approvals"],"method":"POST","path":"/api/v4/projects/{}/merge_requests/{}/approvals","source":{"url":"https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/update/deprecations.md","kind":"archive"},"quote":"To change the approvals required for a merge request, you should no longer use the `/approvals` API endpoint, which was deprecated in GitLab 14.0.","migration":"Create or update merge request approval rules with /api/v4/projects/{id}/merge_requests/{iid}/approval_rules.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:56:46.455Z","updatedAt":"2026-10-23T09:56:46.455Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/gitlab-api/breaking-changes/post-api-v4-projects-merge-requests-approvals-stops-working/"},{"slug":"get-api-v4-projects-merge-requests-changes-is-deprecated","api":"gitlab-api","title":"GET /api/v4/projects/{}/merge_requests/{}/changes is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /api/v4/projects/{}/merge_requests/{}/changes"],"method":"GET","path":"/api/v4/projects/{}/merge_requests/{}/changes","source":{"url":"https://docs.gitlab.com/api/rest/deprecations/","kind":"archive"},"quote":"The changes from a single merge request endpoint will be removed in v5 of the GitLab REST API.","migration":"List the merge request's diffs with GET /api/v4/projects/{id}/merge_requests/{iid}/diffs.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:56:54.842Z","updatedAt":"2026-10-23T09:56:54.842Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/gitlab-api/breaking-changes/get-api-v4-projects-merge-requests-changes-is-deprecated/"}]}