4.9 KiB
4.9 KiB
V3 to V4 version
Our V4 API version is currently available as Beta! It means that V3 will still be supported and remain unchanged for now, but be aware that the following changes are in V4:
8.17
- Removed
/projects/:search
(use:/projects?search=x
) !8877 iid
filter has been removed fromprojects/:id/issues
!8967projects/:id/merge_requests?iid[]=x&iid[]=y
array filter has been renamed toiids
!8793- Endpoints under
projects/merge_request/:id
have been removed (use:projects/merge_requests/:id
) !8793 - Project snippets do not return deprecated field
expires_at
!8723 - Endpoints under
projects/:id/keys
have been removed (useprojects/:id/deploy_keys
) !8716
9.0
- Status 409 returned for POST
project/:id/members
when a member already exists !9093 - Moved
DELETE /projects/:id/star
toPOST /projects/:id/unstar
!9328 - Removed the following deprecated Templates endpoints (these are still accessible with
/templates
prefix) !8853/licences
/licences/:key
/gitignores
/gitlab_ci_ymls
/dockerfiles
/gitignores/:key
/gitlab_ci_ymls/:key
/dockerfiles/:key
- Moved
/projects/fork/:id
to/projects/:id/fork
!8940 - Moved
DELETE /todos
toPOST /todos/mark_as_done
andDELETE /todos/:todo_id
toPOST /todos/:todo_id/mark_as_done
!9410 - Endpoints
/projects/owned
,/projects/visible
,/projects/starred
&/projects/all
are consolidated into/projects
using query parameters !8962 - Return pagination headers for all endpoints that return an array !8606
- Added
POST /environments/:environment_id/stop
to stop an environment !8808 - Removed
DELETE projects/:id/deploy_keys/:key_id/disable
. UseDELETE projects/:id/deploy_keys/:key_id
instead !9366 - Moved
PUT /users/:id/(block|unblock)
toPOST /users/:id/(block|unblock)
!9371 - Make subscription API more RESTful. Use
post ":project_id/:subscribable_type/:subscribable_id/subscribe"
to subscribe andpost ":project_id/:subscribable_type/:subscribable_id/unsubscribe"
to unsubscribe from a resource. !9325 - Labels filter on
projects/:id/issues
and/issues
now matches only issues containing all labels (i.e.: Logical AND, not OR) !8849 - Renamed param
branch_name
tobranch
on the following endpoints !8936- POST
:id/repository/branches
- POST
:id/repository/commits
- POST/PUT/DELETE
:id/repository/files
- POST
- Renamed
merge when build succeeds
to mergewhen pipeline succeeds parameters
on the following endpoints: !9335- PUT
projects/:id/merge_requests/:merge_request_id/merge
- POST
projects/:id/merge_requests/:merge_request_id/cancel_merge_when_pipeline_succeeds
- POST
projects
- POST
projects/user/:user_id
- PUT
projects/:id
- PUT
- Renamed
branch_name
tobranch
on DELETEid/repository/branches/:branch
response !8936 - Remove
public
param from create and edit actions of projects !8736 - Notes do not return deprecated field
upvote
anddownvote
!9384 - Return HTTP status code
400
for all validation errors when creating or updating a member instead of sometimes422
error. !9523 - Remove
GET /groups/owned
. UseGET /groups?owned=true
instead !9505 - Return 202 with JSON body on async removals on V4 API (DELETE
/projects/:id/repository/merged_branches
and DELETE/projects/:id
) !9449