Commit ca68c817 authored by Robert Schilling's avatar Robert Schilling

Update documentation

parent 55f2425a
...@@ -514,7 +514,7 @@ If the user is already subscribed to the issue, the status code `304` ...@@ -514,7 +514,7 @@ If the user is already subscribed to the issue, the status code `304`
is returned. is returned.
``` ```
POST /projects/:id/issues/:issue_id/subscription POST /projects/:id/issues/:issue_id/subscribe
``` ```
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
...@@ -523,7 +523,7 @@ POST /projects/:id/issues/:issue_id/subscription ...@@ -523,7 +523,7 @@ POST /projects/:id/issues/:issue_id/subscription
| `issue_id` | integer | yes | The ID of a project's issue | | `issue_id` | integer | yes | The ID of a project's issue |
```bash ```bash
curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/issues/93/subscription curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/issues/93/subscribe
``` ```
Example response: Example response:
...@@ -569,7 +569,7 @@ from it. If the user is not subscribed to the issue, the ...@@ -569,7 +569,7 @@ from it. If the user is not subscribed to the issue, the
status code `304` is returned. status code `304` is returned.
``` ```
DELETE /projects/:id/issues/:issue_id/subscription DELETE /projects/:id/issues/:issue_id/unsubscribe
``` ```
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
...@@ -578,7 +578,7 @@ DELETE /projects/:id/issues/:issue_id/subscription ...@@ -578,7 +578,7 @@ DELETE /projects/:id/issues/:issue_id/subscription
| `issue_id` | integer | yes | The ID of a project's issue | | `issue_id` | integer | yes | The ID of a project's issue |
```bash ```bash
curl --request DELETE --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/issues/93/subscription curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/issues/93/unsubscribe
``` ```
Example response: Example response:
......
...@@ -188,12 +188,12 @@ Example response: ...@@ -188,12 +188,12 @@ Example response:
## Subscribe to a label ## Subscribe to a label
Subscribes the authenticated user to a label to receive notifications. Subscribes the authenticated user to a label to receive notifications.
If the user is already subscribed to the label, the status code `304` If the user is already subscribed to the label, the status code `304`
is returned. is returned.
``` ```
POST /projects/:id/labels/:label_id/subscription POST /projects/:id/labels/:label_id/subscribe
``` ```
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
...@@ -202,7 +202,7 @@ POST /projects/:id/labels/:label_id/subscription ...@@ -202,7 +202,7 @@ POST /projects/:id/labels/:label_id/subscription
| `label_id` | integer or string | yes | The ID or title of a project's label | | `label_id` | integer or string | yes | The ID or title of a project's label |
```bash ```bash
curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/labels/1/subscription curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/labels/1/subscribe
``` ```
Example response: Example response:
...@@ -228,7 +228,7 @@ from it. If the user is not subscribed to the label, the ...@@ -228,7 +228,7 @@ from it. If the user is not subscribed to the label, the
status code `304` is returned. status code `304` is returned.
``` ```
DELETE /projects/:id/labels/:label_id/subscription DELETE /projects/:id/labels/:label_id/unsubscribe
``` ```
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
...@@ -237,7 +237,7 @@ DELETE /projects/:id/labels/:label_id/subscription ...@@ -237,7 +237,7 @@ DELETE /projects/:id/labels/:label_id/subscription
| `label_id` | integer or string | yes | The ID or title of a project's label | | `label_id` | integer or string | yes | The ID or title of a project's label |
```bash ```bash
curl --request DELETE --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/labels/1/subscription curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/labels/1/unsubscribe
``` ```
Example response: Example response:
......
...@@ -667,7 +667,7 @@ Subscribes the authenticated user to a merge request to receive notification. If ...@@ -667,7 +667,7 @@ Subscribes the authenticated user to a merge request to receive notification. If
status code `304` is returned. status code `304` is returned.
``` ```
POST /projects/:id/merge_requests/:merge_request_id/subscription POST /projects/:id/merge_requests/:merge_request_id/subscribe
``` ```
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
...@@ -676,7 +676,7 @@ POST /projects/:id/merge_requests/:merge_request_id/subscription ...@@ -676,7 +676,7 @@ POST /projects/:id/merge_requests/:merge_request_id/subscription
| `merge_request_id` | integer | yes | The ID of the merge request | | `merge_request_id` | integer | yes | The ID of the merge request |
```bash ```bash
curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/merge_requests/17/subscription curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/merge_requests/17/subscribe
``` ```
Example response: Example response:
...@@ -741,7 +741,7 @@ notifications from that merge request. If the user is ...@@ -741,7 +741,7 @@ notifications from that merge request. If the user is
not subscribed to the merge request, the status code `304` is returned. not subscribed to the merge request, the status code `304` is returned.
``` ```
DELETE /projects/:id/merge_requests/:merge_request_id/subscription DELETE /projects/:id/merge_requests/:merge_request_id/unsubscribe
``` ```
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
...@@ -750,7 +750,7 @@ DELETE /projects/:id/merge_requests/:merge_request_id/subscription ...@@ -750,7 +750,7 @@ DELETE /projects/:id/merge_requests/:merge_request_id/subscription
| `merge_request_id` | integer | yes | The ID of the merge request | | `merge_request_id` | integer | yes | The ID of the merge request |
```bash ```bash
curl --request DELETE --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/merge_requests/17/subscription curl --request POST --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v3/projects/5/merge_requests/17/unsubscribe
``` ```
Example response: Example response:
......
...@@ -29,5 +29,5 @@ changes are in V4: ...@@ -29,5 +29,5 @@ changes are in V4:
- Return pagination headers for all endpoints that return an array - Return pagination headers for all endpoints that return an array
- Removed `DELETE projects/:id/deploy_keys/:key_id/disable`. Use `DELETE projects/:id/deploy_keys/:key_id` instead - Removed `DELETE projects/:id/deploy_keys/:key_id/disable`. Use `DELETE projects/:id/deploy_keys/:key_id` instead
- Moved `PUT /users/:id/(block|unblock)` to `POST /users/:id/(block|unblock)` - Moved `PUT /users/:id/(block|unblock)` to `POST /users/:id/(block|unblock)`
- Make subscription API more RESTful. Use `post ":id/#{type}/:subscribable_id/subscribe"` to subscribe and `post ":id/#{type}/:subscribable_id/unsubscribe"` to unsubscribe from a resource. - Make subscription API more RESTful. Use `post ":project_id/:subscribable_type/:subscribable_id/subscribe"` to subscribe and `post ":project_id/:subscribable_type/:subscribable_id/unsubscribe"` to unsubscribe from a resource.
- Labels filter on `projects/:id/issues` and `/issues` now matches only issues containing all labels (i.e.: Logical AND, not OR) - Labels filter on `projects/:id/issues` and `/issues` now matches only issues containing all labels (i.e.: Logical AND, not OR)
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment