This issue is meant to list all endpoints which are: * deprecated now and should be removed * duplicated and one will be removed * Behavioural change should happen * Exposed info will be hidden * Exposed field will be removed * etc etc Please use the format like we do in regression issues. ## API version change In 8.17: - Add a v4 API version, which has all of the existing v3 endpoints and the changes in this issue that are ready before then. v3 is still the preferred API version, and v4 is beta. - Keep the v3 API around. If there was no change in v4, it can just use the same code as v4. If there was a breaking change, we need to have the old version available under v3 too, with the same behaviour as 8.17. - Add a page in the API docs listing all of these changes in one place, clearly saying that v4 is not done yet, and currently in beta. In 9.0: - Ship all of v4, making it final and no longer beta - Deprecate v3 - Tell the world that "v3 will continue to work until at least 9.2, but we will remove it at some point with no prior warning but a notice in the blogpost, and you should start upgrading your integrations now" In 9.4 or later if there are good technical reasons: - Remove v3 endpoints and code. - Remove the API doc listing the changes. ## Open issues These are the open ~api && ~"breaking change" issues. ### Tough nuts These are quite a lot of work: ### Quick wins These should be easy/quick to tackle: ### In between These aren't really hard, but will take a bit more time: ### Optional These aren't actually breaking anything: - #28017 - API: Separate CE params to avoid wrong conflict resolutions - #20728 - Improve consistency in the way we retrieve project & group in API endpoints <hr> ### Ongoing These are already been working on: ### Done - #20207 - Commits API Pagination Broken (assigned to @oswaldo) - #1381 - Add Link headers for commits (assigned to @oswaldo) - #16834 - Update API endpoints for raw files (assigned to @felipe_artur) - #26843 - API: Make jobs available at top-level (assigned to @to1ne) - Pagination: (assigned to @razer6) - #23302 - API: Pagination for SystemHooks endpoint - #20248 - No pagination on Labels endpoints - #20236 - Tags REST API pagination does not work as expected - #14791 - per_page and page doesn't work in Branches api - #8099 - Paginate all API endpoints that return an array? - #1746 - Problem in Group Members RestAPI pagination - #28286 Remove duplicated endpoint for deleting a deploy key (assigned to @razer6) - #14492 - API endpoint /projects/fork/:id should move to /projects/:id/fork (assigned to @oswaldo) - #23061 - API: consolidate project lists (assigned to @to1ne) - #14596 - [API] PUT should be POST when (un)blocking a user (assigned to @razer6) - #28328 - Make the starring API more RESTful (assigned to @razer6) - #26315 - Use the IssueFinder to filter by labels in the API (assigned to @oswaldo) - #28467 - Deleting a Todo is not very RESTfu l(assigned to @razer6) - #28327 - Make the subscription API more RESTful (assigned to @razer6) - #22132 - Create branch param should be `branch` (assigned to @oswaldo) - #28458 - Present GitLab version for each V3 to V4 API change on `v3_to_v4.md` (assigned to @oswaldo) - #28441 - Remove deprecated upvotes and downvotes field from notes API (assigned to @razer6) - #3874 - [API | BUG] Wrong body on DELETE responses (assigned to @oswaldo) - https://gitlab.com/gitlab-org/gitlab-ee/issues/1791 - Remove project git hooks API endpoints (assigned to @razer6) - #27937 - API: Remove /groups/owned endpoint (assigned to @razer6) - #28702 - Return 400 instead of 422 for access level error in the members API (assigned to @razer6) - #20429 - Make all API `DELETE` endpoints return `204` and respect the `If-Unmodified-Since` header in GitLab 9.0 (assigned to @razer6) - #6073 - API transforms project name to lowercase while form allows uppercases (assigned to @jarka) - gitlab-ee#1790 - Remove `repository_storage` from settings API (assigned to @oswaldo) - #24707 - Rename Merge When Build/Pipeline Succeeds in database and API (assigned to @jameslopez) - #28405 - Cannot use pagination headers at API (assigned to @razer6) - #28257 - API: Add `:iids` filter to V4 `/projects/:id/issues` (assigned to @jarka) - #27532 - API: iid filter changes for projects/:id/milestones (assigned to @jarka) - #27501 - API: Use `visibility` as query parameter everywhere (assigned to @to1ne) - #26847 - `api/v3/projects/:id/pipelines` should use PipelinesBasic (assigned to @to1ne) - #28865 - Allow filtering by authorized projects in the v4 API (assigned to @oswaldo) - #22374 - API /projects/:id/merge_requests is triggering parsing of participants which may not be needed (assigned to @adamniedzielski) - #28598 - Environment should use ProjectBasic entity (assigned to @oswaldo) - #28515 - GitLab API change name from `builds` to either `jobs` or `pipelines` (assigned to @zj) - #28251 - API: Use Issues and MRs IID instead ID for project scope API query (assigned to @timothyandrew) - #27585 - Move `/ci/api/v1` to `/api/v4/ci` (assigned to @tmaczukin) - #28513 - Update GitLab CI API `Builds` resource to be `Jobs` (assigned to @tmaczukin) ### Current doc with V3 to V4 API changes - https://docs.gitlab.com/ce/api/v3_to_v4.html - https://docs.gitlab.com/ee/api/v3_to_v4.html