summaryrefslogtreecommitdiff
path: root/doc/api/v3_to_v4.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/api/v3_to_v4.md')
-rw-r--r--doc/api/v3_to_v4.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/api/v3_to_v4.md b/doc/api/v3_to_v4.md
new file mode 100644
index 00000000000..9748aec17ad
--- /dev/null
+++ b/doc/api/v3_to_v4.md
@@ -0,0 +1,13 @@
+# 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:
+
+### Changes
+
+- Removed `/projects/:search` (use: `/projects?search=x`)
+- `iid` filter has been removed from `projects/:id/issues`
+- `projects/:id/merge_requests?iid[]=x&iid[]=y` array filter has been renamed to `iids`
+- Endpoints under `projects/merge_request/:id` have been removed (use: `projects/merge_requests/:id`)
+