2014-05-27 12:12:15 +00:00
|
|
|
# Notes
|
|
|
|
|
2014-06-13 11:24:54 +00:00
|
|
|
Notes are comments on snippets, issues or merge requests.
|
2013-02-20 21:17:05 +00:00
|
|
|
|
|
|
|
## Issues
|
|
|
|
|
|
|
|
### List project issue notes
|
|
|
|
|
2015-11-21 20:36:31 +00:00
|
|
|
Gets a list of all notes for a single issue. With GitLab 8.2 the return fields
|
|
|
|
`upvote` and `downvote` are deprecated and always return `false`.
|
2012-11-29 20:32:05 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
GET /projects/:id/issues/:issue_id/notes
|
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
2014-08-15 07:03:18 +00:00
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `issue_id` (required) - The ID of an issue
|
2012-11-29 20:32:05 +00:00
|
|
|
|
2013-10-02 10:08:07 +00:00
|
|
|
```json
|
|
|
|
[
|
|
|
|
{
|
2014-04-05 06:36:47 +00:00
|
|
|
"id": 302,
|
2015-03-12 16:11:59 +00:00
|
|
|
"body": "Status changed to closed",
|
2014-04-05 06:36:47 +00:00
|
|
|
"attachment": null,
|
|
|
|
"author": {
|
|
|
|
"id": 1,
|
|
|
|
"username": "pipin",
|
|
|
|
"email": "admin@example.com",
|
|
|
|
"name": "Pip",
|
|
|
|
"state": "active",
|
|
|
|
"created_at": "2013-09-30T13:46:01Z"
|
2013-10-02 10:08:07 +00:00
|
|
|
},
|
2015-08-12 19:39:58 +00:00
|
|
|
"created_at": "2013-10-02T09:22:45Z",
|
2015-11-21 20:36:31 +00:00
|
|
|
"system": true,
|
|
|
|
"upvote": false,
|
2015-12-04 11:21:06 +00:00
|
|
|
"downvote": false,
|
|
|
|
"noteable_id": 377,
|
|
|
|
"noteable_type": "Issue"
|
2013-10-02 10:08:07 +00:00
|
|
|
},
|
|
|
|
{
|
2014-04-05 06:36:47 +00:00
|
|
|
"id": 305,
|
|
|
|
"body": "Text of the comment\r\n",
|
|
|
|
"attachment": null,
|
|
|
|
"author": {
|
|
|
|
"id": 1,
|
|
|
|
"username": "pipin",
|
|
|
|
"email": "admin@example.com",
|
|
|
|
"name": "Pip",
|
|
|
|
"state": "active",
|
|
|
|
"created_at": "2013-09-30T13:46:01Z"
|
2013-10-02 10:08:07 +00:00
|
|
|
},
|
2015-08-12 19:39:58 +00:00
|
|
|
"created_at": "2013-10-02T09:56:03Z",
|
2015-11-21 20:36:31 +00:00
|
|
|
"system": true,
|
|
|
|
"upvote": false,
|
2015-12-04 11:21:06 +00:00
|
|
|
"downvote": false,
|
|
|
|
"noteable_id": 121,
|
|
|
|
"noteable_type": "Issue"
|
2013-10-02 10:08:07 +00:00
|
|
|
}
|
|
|
|
]
|
|
|
|
```
|
2013-02-20 21:17:05 +00:00
|
|
|
|
|
|
|
### Get single issue note
|
|
|
|
|
|
|
|
Returns a single note for a specific project issue
|
2012-11-29 20:32:05 +00:00
|
|
|
|
|
|
|
```
|
2013-02-20 21:17:05 +00:00
|
|
|
GET /projects/:id/issues/:issue_id/notes/:note_id
|
2012-11-29 20:32:05 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
2014-08-15 07:03:18 +00:00
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `issue_id` (required) - The ID of a project issue
|
|
|
|
- `note_id` (required) - The ID of an issue note
|
2012-11-29 20:32:05 +00:00
|
|
|
|
2013-02-20 21:17:05 +00:00
|
|
|
### Create new issue note
|
2012-12-01 10:20:45 +00:00
|
|
|
|
2013-02-20 21:17:05 +00:00
|
|
|
Creates a new note to a single project issue.
|
2012-12-01 10:20:45 +00:00
|
|
|
|
|
|
|
```
|
2013-02-20 21:17:05 +00:00
|
|
|
POST /projects/:id/issues/:issue_id/notes
|
2012-12-01 10:20:45 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
2014-08-15 07:03:18 +00:00
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `issue_id` (required) - The ID of an issue
|
|
|
|
- `body` (required) - The content of a note
|
2013-02-20 21:17:05 +00:00
|
|
|
|
2014-09-02 15:12:13 +00:00
|
|
|
### Modify existing issue note
|
|
|
|
|
|
|
|
Modify existing note of an issue.
|
|
|
|
|
|
|
|
```
|
|
|
|
PUT /projects/:id/issues/:issue_id/notes/:note_id
|
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `issue_id` (required) - The ID of an issue
|
|
|
|
- `note_id` (required) - The ID of a note
|
|
|
|
- `body` (required) - The content of a note
|
|
|
|
|
2013-02-20 21:17:05 +00:00
|
|
|
## Snippets
|
|
|
|
|
|
|
|
### List all snippet notes
|
|
|
|
|
|
|
|
Gets a list of all notes for a single snippet. Snippet notes are comments users can post to a snippet.
|
2012-11-29 20:32:05 +00:00
|
|
|
|
|
|
|
```
|
2013-02-20 21:17:05 +00:00
|
|
|
GET /projects/:id/snippets/:snippet_id/notes
|
2012-11-29 20:32:05 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
2014-08-15 07:03:18 +00:00
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `snippet_id` (required) - The ID of a project snippet
|
2012-11-29 20:32:05 +00:00
|
|
|
|
2013-02-20 21:17:05 +00:00
|
|
|
### Get single snippet note
|
2012-11-29 20:32:05 +00:00
|
|
|
|
2013-02-20 21:17:05 +00:00
|
|
|
Returns a single note for a given snippet.
|
2012-11-29 20:32:05 +00:00
|
|
|
|
|
|
|
```
|
2013-02-20 21:17:05 +00:00
|
|
|
GET /projects/:id/snippets/:snippet_id/notes/:note_id
|
2012-11-29 20:32:05 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
2014-08-15 07:03:18 +00:00
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `snippet_id` (required) - The ID of a project snippet
|
|
|
|
- `note_id` (required) - The ID of an snippet note
|
2012-11-29 20:32:05 +00:00
|
|
|
|
2013-10-02 10:08:07 +00:00
|
|
|
```json
|
|
|
|
{
|
2014-04-05 06:36:47 +00:00
|
|
|
"id": 52,
|
|
|
|
"title": "Snippet",
|
|
|
|
"file_name": "snippet.rb",
|
|
|
|
"author": {
|
|
|
|
"id": 1,
|
|
|
|
"username": "pipin",
|
|
|
|
"email": "admin@example.com",
|
|
|
|
"name": "Pip",
|
|
|
|
"state": "active",
|
|
|
|
"created_at": "2013-09-30T13:46:01Z"
|
2013-10-02 10:08:07 +00:00
|
|
|
},
|
2014-04-05 06:36:47 +00:00
|
|
|
"expires_at": null,
|
|
|
|
"updated_at": "2013-10-02T07:34:20Z",
|
|
|
|
"created_at": "2013-10-02T07:34:20Z"
|
2013-10-02 10:08:07 +00:00
|
|
|
}
|
|
|
|
```
|
2013-02-20 21:17:05 +00:00
|
|
|
|
|
|
|
### Create new snippet note
|
|
|
|
|
|
|
|
Creates a new note for a single snippet. Snippet notes are comments users can post to a snippet.
|
2012-11-29 23:52:56 +00:00
|
|
|
|
|
|
|
```
|
2013-02-20 21:17:05 +00:00
|
|
|
POST /projects/:id/snippets/:snippet_id/notes
|
2012-11-29 23:52:56 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
2014-08-15 07:03:18 +00:00
|
|
|
- `id` (required) - The ID of a project
|
2014-09-02 15:12:13 +00:00
|
|
|
- `snippet_id` (required) - The ID of a snippet
|
|
|
|
- `body` (required) - The content of a note
|
|
|
|
|
|
|
|
### Modify existing snippet note
|
|
|
|
|
|
|
|
Modify existing note of a snippet.
|
|
|
|
|
|
|
|
```
|
|
|
|
PUT /projects/:id/snippets/:snippet_id/notes/:note_id
|
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `snippet_id` (required) - The ID of a snippet
|
|
|
|
- `note_id` (required) - The ID of a note
|
2014-08-15 07:03:18 +00:00
|
|
|
- `body` (required) - The content of a note
|
2013-02-20 21:17:05 +00:00
|
|
|
|
|
|
|
## Merge Requests
|
|
|
|
|
|
|
|
### List all merge request notes
|
|
|
|
|
|
|
|
Gets a list of all notes for a single merge request.
|
2012-11-29 20:32:05 +00:00
|
|
|
|
|
|
|
```
|
2013-02-20 21:17:05 +00:00
|
|
|
GET /projects/:id/merge_requests/:merge_request_id/notes
|
2012-11-29 20:32:05 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
2014-08-15 07:03:18 +00:00
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `merge_request_id` (required) - The ID of a project merge request
|
2012-11-29 20:32:05 +00:00
|
|
|
|
2013-02-20 21:17:05 +00:00
|
|
|
### Get single merge request note
|
|
|
|
|
|
|
|
Returns a single note for a given merge request.
|
2012-11-29 20:32:05 +00:00
|
|
|
|
|
|
|
```
|
2013-02-20 21:17:05 +00:00
|
|
|
GET /projects/:id/merge_requests/:merge_request_id/notes/:note_id
|
2012-11-29 20:32:05 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
2014-08-15 07:03:18 +00:00
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `merge_request_id` (required) - The ID of a project merge request
|
|
|
|
- `note_id` (required) - The ID of a merge request note
|
2013-02-20 21:17:05 +00:00
|
|
|
|
2013-10-02 10:08:07 +00:00
|
|
|
```json
|
|
|
|
{
|
2014-04-05 06:36:47 +00:00
|
|
|
"id": 301,
|
|
|
|
"body": "Comment for MR",
|
|
|
|
"attachment": null,
|
|
|
|
"author": {
|
|
|
|
"id": 1,
|
|
|
|
"username": "pipin",
|
|
|
|
"email": "admin@example.com",
|
|
|
|
"name": "Pip",
|
|
|
|
"state": "active",
|
|
|
|
"created_at": "2013-09-30T13:46:01Z"
|
2013-10-02 10:08:07 +00:00
|
|
|
},
|
2015-12-04 11:21:06 +00:00
|
|
|
"created_at": "2013-10-02T08:57:14Z",
|
|
|
|
"system": false,
|
|
|
|
"upvote": false,
|
|
|
|
"downvote": false,
|
|
|
|
"noteable_id": 2,
|
|
|
|
"noteable_type": "MergeRequest"
|
2013-10-02 10:08:07 +00:00
|
|
|
}
|
|
|
|
```
|
2013-02-20 21:17:05 +00:00
|
|
|
|
|
|
|
### Create new merge request note
|
|
|
|
|
|
|
|
Creates a new note for a single merge request.
|
|
|
|
|
|
|
|
```
|
|
|
|
POST /projects/:id/merge_requests/:merge_request_id/notes
|
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
2014-08-15 07:03:18 +00:00
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `merge_request_id` (required) - The ID of a merge request
|
|
|
|
- `body` (required) - The content of a note
|
2014-09-02 15:12:13 +00:00
|
|
|
|
|
|
|
### Modify existing merge request note
|
|
|
|
|
|
|
|
Modify existing note of a merge request.
|
|
|
|
|
|
|
|
```
|
|
|
|
PUT /projects/:id/merge_requests/:merge_request_id/notes/:note_id
|
|
|
|
```
|
|
|
|
|
|
|
|
Parameters:
|
|
|
|
|
|
|
|
- `id` (required) - The ID of a project
|
|
|
|
- `merge_request_id` (required) - The ID of a merge request
|
|
|
|
- `note_id` (required) - The ID of a note
|
|
|
|
- `body` (required) - The content of a note
|