Move branches API docs to separate file
Signed-off-by: Dmitriy Zaporozhets <dmitriy.zaporozhets@gmail.com>
This commit is contained in:
parent
9b276f0003
commit
8f3701eff0
|
@ -9,6 +9,7 @@
|
||||||
+ [Repositories](repositories.md)
|
+ [Repositories](repositories.md)
|
||||||
+ [Repository Files](repository_files.md)
|
+ [Repository Files](repository_files.md)
|
||||||
+ [Commits](commits.md)
|
+ [Commits](commits.md)
|
||||||
|
+ [Branches](branches.md)
|
||||||
+ [Merge Requests](merge_requests.md)
|
+ [Merge Requests](merge_requests.md)
|
||||||
+ [Issues](issues.md)
|
+ [Issues](issues.md)
|
||||||
+ [Milestones](milestones.md)
|
+ [Milestones](milestones.md)
|
||||||
|
|
|
@ -0,0 +1,167 @@
|
||||||
|
# Branches
|
||||||
|
|
||||||
|
## List repository branches
|
||||||
|
|
||||||
|
Get a list of repository branches from a project, sorted by name alphabetically.
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /projects/:id/repository/branches
|
||||||
|
```
|
||||||
|
|
||||||
|
Parameters:
|
||||||
|
|
||||||
|
+ `id` (required) - The ID of a project
|
||||||
|
|
||||||
|
```json
|
||||||
|
[
|
||||||
|
{
|
||||||
|
"name": "master",
|
||||||
|
"commit": {
|
||||||
|
"id": "7b5c3cc8be40ee161ae89a06bba6229da1032a0c",
|
||||||
|
"parents": [
|
||||||
|
{
|
||||||
|
"id": "4ad91d3c1144c406e50c7b33bae684bd6837faf8"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"tree": "46e82de44b1061621357f24c05515327f2795a95",
|
||||||
|
"message": "add projects API",
|
||||||
|
"author": {
|
||||||
|
"name": "John Smith",
|
||||||
|
"email": "john@example.com"
|
||||||
|
},
|
||||||
|
"committer": {
|
||||||
|
"name": "John Smith",
|
||||||
|
"email": "john@example.com"
|
||||||
|
},
|
||||||
|
"authored_date": "2012-06-27T05:51:39-07:00",
|
||||||
|
"committed_date": "2012-06-28T03:44:20-07:00"
|
||||||
|
},
|
||||||
|
"protected": true
|
||||||
|
}
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## Get single repository branch
|
||||||
|
|
||||||
|
Get a single project repository branch.
|
||||||
|
|
||||||
|
```
|
||||||
|
GET /projects/:id/repository/branches/:branch
|
||||||
|
```
|
||||||
|
|
||||||
|
Parameters:
|
||||||
|
|
||||||
|
+ `id` (required) - The ID of a project
|
||||||
|
+ `branch` (required) - The name of the branch
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "master",
|
||||||
|
"commit": {
|
||||||
|
"id": "7b5c3cc8be40ee161ae89a06bba6229da1032a0c",
|
||||||
|
"parents": [
|
||||||
|
{
|
||||||
|
"id": "4ad91d3c1144c406e50c7b33bae684bd6837faf8"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"tree": "46e82de44b1061621357f24c05515327f2795a95",
|
||||||
|
"message": "add projects API",
|
||||||
|
"author": {
|
||||||
|
"name": "John Smith",
|
||||||
|
"email": "john@example.com"
|
||||||
|
},
|
||||||
|
"committer": {
|
||||||
|
"name": "John Smith",
|
||||||
|
"email": "john@example.com"
|
||||||
|
},
|
||||||
|
"authored_date": "2012-06-27T05:51:39-07:00",
|
||||||
|
"committed_date": "2012-06-28T03:44:20-07:00"
|
||||||
|
},
|
||||||
|
"protected": true
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## Protect repository branch
|
||||||
|
|
||||||
|
Protects a single project repository branch. This is an idempotent function, protecting an already
|
||||||
|
protected repository branch still returns a `200 Ok` status code.
|
||||||
|
|
||||||
|
```
|
||||||
|
PUT /projects/:id/repository/branches/:branch/protect
|
||||||
|
```
|
||||||
|
|
||||||
|
Parameters:
|
||||||
|
|
||||||
|
+ `id` (required) - The ID of a project
|
||||||
|
+ `branch` (required) - The name of the branch
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "master",
|
||||||
|
"commit": {
|
||||||
|
"id": "7b5c3cc8be40ee161ae89a06bba6229da1032a0c",
|
||||||
|
"parents": [
|
||||||
|
{
|
||||||
|
"id": "4ad91d3c1144c406e50c7b33bae684bd6837faf8"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"tree": "46e82de44b1061621357f24c05515327f2795a95",
|
||||||
|
"message": "add projects API",
|
||||||
|
"author": {
|
||||||
|
"name": "John Smith",
|
||||||
|
"email": "john@example.com"
|
||||||
|
},
|
||||||
|
"committer": {
|
||||||
|
"name": "John Smith",
|
||||||
|
"email": "john@example.com"
|
||||||
|
},
|
||||||
|
"authored_date": "2012-06-27T05:51:39-07:00",
|
||||||
|
"committed_date": "2012-06-28T03:44:20-07:00"
|
||||||
|
},
|
||||||
|
"protected": true
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## Unprotect repository branch
|
||||||
|
|
||||||
|
Unprotects a single project repository branch. This is an idempotent function, unprotecting an already
|
||||||
|
unprotected repository branch still returns a `200 Ok` status code.
|
||||||
|
|
||||||
|
```
|
||||||
|
PUT /projects/:id/repository/branches/:branch/unprotect
|
||||||
|
```
|
||||||
|
|
||||||
|
Parameters:
|
||||||
|
|
||||||
|
+ `id` (required) - The ID of a project
|
||||||
|
+ `branch` (required) - The name of the branch
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"name": "master",
|
||||||
|
"commit": {
|
||||||
|
"id": "7b5c3cc8be40ee161ae89a06bba6229da1032a0c",
|
||||||
|
"parents": [
|
||||||
|
{
|
||||||
|
"id": "4ad91d3c1144c406e50c7b33bae684bd6837faf8"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"tree": "46e82de44b1061621357f24c05515327f2795a95",
|
||||||
|
"message": "add projects API",
|
||||||
|
"author": {
|
||||||
|
"name": "John Smith",
|
||||||
|
"email": "john@example.com"
|
||||||
|
},
|
||||||
|
"committer": {
|
||||||
|
"name": "John Smith",
|
||||||
|
"email": "john@example.com"
|
||||||
|
},
|
||||||
|
"authored_date": "2012-06-27T05:51:39-07:00",
|
||||||
|
"committed_date": "2012-06-28T03:44:20-07:00"
|
||||||
|
},
|
||||||
|
"protected": false
|
||||||
|
}
|
||||||
|
```
|
|
@ -1,170 +1,3 @@
|
||||||
## List repository branches
|
|
||||||
|
|
||||||
Get a list of repository branches from a project, sorted by name alphabetically.
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /projects/:id/repository/branches
|
|
||||||
```
|
|
||||||
|
|
||||||
Parameters:
|
|
||||||
|
|
||||||
+ `id` (required) - The ID of a project
|
|
||||||
|
|
||||||
```json
|
|
||||||
[
|
|
||||||
{
|
|
||||||
"name": "master",
|
|
||||||
"commit": {
|
|
||||||
"id": "7b5c3cc8be40ee161ae89a06bba6229da1032a0c",
|
|
||||||
"parents": [
|
|
||||||
{
|
|
||||||
"id": "4ad91d3c1144c406e50c7b33bae684bd6837faf8"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"tree": "46e82de44b1061621357f24c05515327f2795a95",
|
|
||||||
"message": "add projects API",
|
|
||||||
"author": {
|
|
||||||
"name": "John Smith",
|
|
||||||
"email": "john@example.com"
|
|
||||||
},
|
|
||||||
"committer": {
|
|
||||||
"name": "John Smith",
|
|
||||||
"email": "john@example.com"
|
|
||||||
},
|
|
||||||
"authored_date": "2012-06-27T05:51:39-07:00",
|
|
||||||
"committed_date": "2012-06-28T03:44:20-07:00"
|
|
||||||
},
|
|
||||||
"protected": true
|
|
||||||
}
|
|
||||||
]
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## Get single repository branch
|
|
||||||
|
|
||||||
Get a single project repository branch.
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /projects/:id/repository/branches/:branch
|
|
||||||
```
|
|
||||||
|
|
||||||
Parameters:
|
|
||||||
|
|
||||||
+ `id` (required) - The ID of a project
|
|
||||||
+ `branch` (required) - The name of the branch
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"name": "master",
|
|
||||||
"commit": {
|
|
||||||
"id": "7b5c3cc8be40ee161ae89a06bba6229da1032a0c",
|
|
||||||
"parents": [
|
|
||||||
{
|
|
||||||
"id": "4ad91d3c1144c406e50c7b33bae684bd6837faf8"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"tree": "46e82de44b1061621357f24c05515327f2795a95",
|
|
||||||
"message": "add projects API",
|
|
||||||
"author": {
|
|
||||||
"name": "John Smith",
|
|
||||||
"email": "john@example.com"
|
|
||||||
},
|
|
||||||
"committer": {
|
|
||||||
"name": "John Smith",
|
|
||||||
"email": "john@example.com"
|
|
||||||
},
|
|
||||||
"authored_date": "2012-06-27T05:51:39-07:00",
|
|
||||||
"committed_date": "2012-06-28T03:44:20-07:00"
|
|
||||||
},
|
|
||||||
"protected": true
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## Protect repository branch
|
|
||||||
|
|
||||||
Protects a single project repository branch. This is an idempotent function, protecting an already
|
|
||||||
protected repository branch still returns a `200 Ok` status code.
|
|
||||||
|
|
||||||
```
|
|
||||||
PUT /projects/:id/repository/branches/:branch/protect
|
|
||||||
```
|
|
||||||
|
|
||||||
Parameters:
|
|
||||||
|
|
||||||
+ `id` (required) - The ID of a project
|
|
||||||
+ `branch` (required) - The name of the branch
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"name": "master",
|
|
||||||
"commit": {
|
|
||||||
"id": "7b5c3cc8be40ee161ae89a06bba6229da1032a0c",
|
|
||||||
"parents": [
|
|
||||||
{
|
|
||||||
"id": "4ad91d3c1144c406e50c7b33bae684bd6837faf8"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"tree": "46e82de44b1061621357f24c05515327f2795a95",
|
|
||||||
"message": "add projects API",
|
|
||||||
"author": {
|
|
||||||
"name": "John Smith",
|
|
||||||
"email": "john@example.com"
|
|
||||||
},
|
|
||||||
"committer": {
|
|
||||||
"name": "John Smith",
|
|
||||||
"email": "john@example.com"
|
|
||||||
},
|
|
||||||
"authored_date": "2012-06-27T05:51:39-07:00",
|
|
||||||
"committed_date": "2012-06-28T03:44:20-07:00"
|
|
||||||
},
|
|
||||||
"protected": true
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## Unprotect repository branch
|
|
||||||
|
|
||||||
Unprotects a single project repository branch. This is an idempotent function, unprotecting an already
|
|
||||||
unprotected repository branch still returns a `200 Ok` status code.
|
|
||||||
|
|
||||||
```
|
|
||||||
PUT /projects/:id/repository/branches/:branch/unprotect
|
|
||||||
```
|
|
||||||
|
|
||||||
Parameters:
|
|
||||||
|
|
||||||
+ `id` (required) - The ID of a project
|
|
||||||
+ `branch` (required) - The name of the branch
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"name": "master",
|
|
||||||
"commit": {
|
|
||||||
"id": "7b5c3cc8be40ee161ae89a06bba6229da1032a0c",
|
|
||||||
"parents": [
|
|
||||||
{
|
|
||||||
"id": "4ad91d3c1144c406e50c7b33bae684bd6837faf8"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"tree": "46e82de44b1061621357f24c05515327f2795a95",
|
|
||||||
"message": "add projects API",
|
|
||||||
"author": {
|
|
||||||
"name": "John Smith",
|
|
||||||
"email": "john@example.com"
|
|
||||||
},
|
|
||||||
"committer": {
|
|
||||||
"name": "John Smith",
|
|
||||||
"email": "john@example.com"
|
|
||||||
},
|
|
||||||
"authored_date": "2012-06-27T05:51:39-07:00",
|
|
||||||
"committed_date": "2012-06-28T03:44:20-07:00"
|
|
||||||
},
|
|
||||||
"protected": false
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## List project repository tags
|
## List project repository tags
|
||||||
|
|
||||||
Get a list of repository tags from a project, sorted by name in reverse alphabetical order.
|
Get a list of repository tags from a project, sorted by name in reverse alphabetical order.
|
||||||
|
|
Loading…
Reference in New Issue