diff options
author | Tomasz Maczukin <tomasz@maczukin.pl> | 2016-01-13 21:19:18 +0100 |
---|---|---|
committer | Tomasz Maczukin <tomasz@maczukin.pl> | 2016-01-13 21:19:18 +0100 |
commit | 4cdbb2f628620be90de872cf7f5cd591e17c1bd0 (patch) | |
tree | 2557ffbaaee951f66ebccac1cad3faadd9c8c406 /doc | |
parent | 9280511979caaf46e27505578818c770da9c9837 (diff) | |
download | gitlab-ce-4cdbb2f628620be90de872cf7f5cd591e17c1bd0.tar.gz |
Modify builds API documentation style [ci skip]
Diffstat (limited to 'doc')
-rw-r--r-- | doc/api/builds.md | 82 |
1 files changed, 66 insertions, 16 deletions
diff --git a/doc/api/builds.md b/doc/api/builds.md index 06ff89bea00..ecb50754c88 100644 --- a/doc/api/builds.md +++ b/doc/api/builds.md @@ -8,10 +8,20 @@ Get a list of builds in a project. GET /projects/:id/builds ``` -Parameters: +### Parameters -- `id` (required) - The ID of a project -- `scope` (optional) - The scope of builds to show (one or array of: pending, running, failed, success, canceled; if none provided showing all builds) +| Attribute | Type | required | Description | +|-----------|---------|----------|---------------------| +| id | integer | yes | The ID of a project | +| scope | string|array of strings | no | The scope of builds to show, one or array of: `pending`, `running`, `failed`, `success`, `canceled`; showing all builds if none provided | + +### Example of request + +``` +curl -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/1/builds" +``` + +### Example of response ```json [ @@ -102,11 +112,21 @@ Get a list of builds for specific commit in a project. GET /projects/:id/repository/commits/:sha/builds ``` -Parameters: +### Parameters + +| Attribute | Type | required | Description | +|-----------|---------|----------|---------------------| +| id | integer | yes | The ID of a project | +| sha | string | yes | The SHA id of a commit | +| scope | string|array of strings | no | The scope of builds to show, one or array of: `pending`, `running`, `failed`, `success`, `canceled`; showing all builds if none provided | -- `id` (required) - The ID of a project -- `sha` (required) - The SHA id of a commit -- `scope` (optional) - The scope of builds to show (one or array of: pending, running, failed, success, canceled; if none provided showing all builds) +### Example of request + +``` +curl -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/1/repository/commits/0ff3ae198f8601a285adcf5c0fff204ee6fba5fd/builds" +``` + +### Example of response ```json [ @@ -183,10 +203,20 @@ Get a single build of a project GET /projects/:id/builds/:build_id ``` -Parameters: +### Parameters -- `id` (required) - The ID of a project -- `build_id` (required) - The ID of a build +| Attribute | Type | required | Description | +|-----------|---------|----------|---------------------| +| id | integer | yes | The ID of a project | +| build\_id | integer | yes | The ID of a build | + +### Example of request + +``` +curl -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/1/builds/8" +``` + +### Example of response ```json { @@ -237,10 +267,20 @@ Cancel a single build of a project POST /projects/:id/builds/:build_id/cancel ``` -Parameters: +### Parameters + +| Attribute | Type | required | Description | +|-----------|---------|----------|---------------------| +| id | integer | yes | The ID of a project | +| build\_id | integer | yes | The ID of a build | + +### Example of request + +``` +curl -X POST -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/1/builds/1/cancel" +``` -- `id` (required) - The ID of a project -- `build_id` (required) - The ID of a build +### Example of response ```json { @@ -277,10 +317,20 @@ Retry a single build of a project POST /projects/:id/builds/:build_id/retry ``` -Parameters: +### Parameters + +| Attribute | Type | required | Description | +|-----------|---------|----------|---------------------| +| id | integer | yes | The ID of a project | +| build\_id | integer | yes | The ID of a build | + +### Example of request + +``` +curl -X POST -H "PRIVATE_TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v3/projects/1/builds/1/retry" +``` -- `id` (required) - The ID of a project -- `build_id` (required) - The ID of a build +### Example of response ```json { |