10 KiB
Builds API
List project builds
Get a list of builds in a project.
GET /projects/:id/builds
Parameters:
id(required) - The ID of a projectscope(optional) - The scope of builds to show (one or array of: pending, running, failed, success, canceled; if none provided showing all builds)
[
{
"commit": {
"author_email": "admin@example.com",
"author_name": "Administrator",
"created_at": "2015-12-24T16:51:14.000+01:00",
"id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
"message": "Test the CI integration.",
"short_id": "0ff3ae19",
"title": "Test the CI integration."
},
"coverage": null,
"created_at": "2015-12-24T15:51:21.802Z",
"download_url": null,
"finished_at": "2015-12-24T17:54:27.895Z",
"id": 7,
"name": "teaspoon",
"ref": "master",
"runner": null,
"stage": "test",
"started_at": "2015-12-24T17:54:27.722Z",
"status": "failed",
"tag": false,
"user": {
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
"bio": null,
"can_create_group": true,
"can_create_project": true,
"color_scheme_id": 2,
"created_at": "2015-12-21T13:14:24.077Z",
"current_sign_in_at": "2016-01-11T09:31:40.472Z",
"email": "admin@example.com",
"id": 1,
"identities": [],
"is_admin": true,
"linkedin": "",
"name": "Administrator",
"projects_limit": 100,
"skype": "",
"state": "active",
"theme_id": 3,
"twitter": "",
"two_factor_enabled": false,
"username": "root",
"web_url": "http://gitlab.dev/u/root",
"website_url": ""
}
},
{
"commit": {
"author_email": "admin@example.com",
"author_name": "Administrator",
"created_at": "2015-12-24T16:51:14.000+01:00",
"id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
"message": "Test the CI integration.",
"short_id": "0ff3ae19",
"title": "Test the CI integration."
},
"coverage": null,
"created_at": "2015-12-24T15:51:21.727Z",
"download_url": null,
"finished_at": "2015-12-24T17:54:24.921Z",
"id": 6,
"name": "spinach:other",
"ref": "master",
"runner": null,
"stage": "test",
"started_at": "2015-12-24T17:54:24.729Z",
"status": "failed",
"tag": false,
"user": {
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
"bio": null,
"can_create_group": true,
"can_create_project": true,
"color_scheme_id": 2,
"created_at": "2015-12-21T13:14:24.077Z",
"current_sign_in_at": "2016-01-11T09:31:40.472Z",
"email": "admin@example.com",
"id": 1,
"identities": [],
"is_admin": true,
"linkedin": "",
"name": "Administrator",
"projects_limit": 100,
"skype": "",
"state": "active",
"theme_id": 3,
"twitter": "",
"two_factor_enabled": false,
"username": "root",
"web_url": "http://gitlab.dev/u/root",
"website_url": ""
}
}
]
List commit builds
Get a list of builds for specific commit in a project.
GET /projects/:id/repository/commits/:sha/builds
Parameters:
id(required) - The ID of a projectsha(required) - The SHA id of a commitscope(optional) - The scope of builds to show (one or array of: pending, running, failed, success, canceled; if none provided showing all builds)
Get a single build
mmit": { "author_email": "admin@example.com", "author_name": "Administrator", "created_at": "2015-12-24T16:51:14.000+01:00", "id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd", "message": "Test the CI integration.", "short_id": "0ff3ae19", "title": "Test the CI integration." }, "coverage": null, "created_at": "2015-12-24T15:51:21.957Z", "download_url": null, "finished_at": "2015-12-24T17:54:33.913Z", "id": 9, "name": "brakeman", "ref": "master", "runner": null, "stage": "test", "started_at": "2015-12-24T17:54:33.727Z", "status": "failed", "tag": false, "user": { "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon", "bio": null, "can_create_group": true, "can_create_project": true, "color_scheme_id": 2, "created_at": "2015-12-21T13:14:24.077Z", "current_sign_in_at": "2016-01-11T09:31:40.472Z", "email": "admin@example.com", "id": 1, "identities": [], "is_admin": true, "linkedin": "", "name": "Administrator", "projects_limit": 100, "skype": "", "state": "active", "theme_id": 3, "twitter": "", "two_factor_enabled": false, "username": "root", "web_url": "http://gitlab.dev/u/root", "website_url": "" } }, { "commit": { "author_email": "admin@example.com", "author_name": "Administrator", "created_at": "2015-12-24T16:51:14.000+01:00", "id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd", "message": "Test the CI integration.", "short_id": "0ff3ae19", "title": "Test the CI integration." }, "coverage": null, "created_at": "2015-12-24T15:51:21.880Z", "download_url": null, "finished_at": "2015-12-24T17:54:31.198Z", "id": 8, "name": "rubocop", "ref": "master", "runner": null, "stage": "test", "started_at": "2015-12-24T17:54:30.733Z", "status": "failed", "tag": false, "user": { "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon", "bio": null, "can_create_group": true, "can_create_project": true, "color_scheme_id": 2, "created_at": "2015-12-21T13:14:24.077Z", "current_sign_in_at": "2016-01-11T09:31:40.472Z", "email": "admin@example.com", "id": 1, "identities": [], "is_admin": true, "linkedin": "", "name": "Administrator", "projects_limit": 100, "skype": "", "state": "active", "theme_id": 3, "twitter": "", "two_factor_enabled": false, "username": "root", "web_url": "http://gitlab.dev/u/root", "website_url": "" } } ]
Get a single build of a project
GET /projects/:id/builds/:build_id
Parameters:
id(required) - The ID of a projectbuild_id(required) - The ID of a build
{
"commit": {
"author_email": "admin@example.com",
"author_name": "Administrator",
"created_at": "2015-12-24T16:51:14.000+01:00",
"id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
"message": "Test the CI integration.",
"short_id": "0ff3ae19",
"title": "Test the CI integration."
},
"coverage": null,
"created_at": "2015-12-24T15:51:21.880Z",
"download_url": null,
"finished_at": "2015-12-24T17:54:31.198Z",
"id": 8,
"name": "rubocop",
"ref": "master",
"runner": null,
"stage": "test",
"started_at": "2015-12-24T17:54:30.733Z",
"status": "failed",
"tag": false,
"user": {
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
"bio": null,
"can_create_group": true,
"can_create_project": true,
"color_scheme_id": 2,
"created_at": "2015-12-21T13:14:24.077Z",
"current_sign_in_at": "2016-01-11T09:31:40.472Z",
"email": "admin@example.com",
"id": 1,
"identities": [],
"is_admin": true,
"linkedin": "",
"name": "Administrator",
"projects_limit": 100,
"skype": "",
"state": "active",
"theme_id": 3,
"twitter": "",
"two_factor_enabled": false,
"username": "root",
"web_url": "http://gitlab.dev/u/root",
"website_url": ""
}
}
Cancel a build
Cancel a single build of a project
POST /projects/:id/builds/:build_id/cancel
Parameters:
id(required) - The ID of a projectbuild_id(required) - The ID of a build
{
"commit": {
"author_email": "admin@example.com",
"author_name": "Administrator",
"created_at": "2015-12-24T16:51:14.000+01:00",
"id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
"message": "Test the CI integration.",
"short_id": "0ff3ae19",
"title": "Test the CI integration."
},
"coverage": null,
"created_at": "2016-01-11T10:13:33.506Z",
"download_url": null,
"finished_at": "2016-01-11T10:14:09.526Z",
"id": 69,
"name": "rubocop",
"ref": "master",
"runner": null,
"stage": "test",
"started_at": null,
"status": "canceled",
"tag": false,
"user": null
}
Retry a build
Retry a single build of a project
POST /projects/:id/builds/:build_id/retry
Parameters:
id(required) - The ID of a projectbuild_id(required) - The ID of a build
{
"commit": {
"author_email": "admin@example.com",
"author_name": "Administrator",
"created_at": "2015-12-24T16:51:14.000+01:00",
"id": "0ff3ae198f8601a285adcf5c0fff204ee6fba5fd",
"message": "Test the CI integration.",
"short_id": "0ff3ae19",
"title": "Test the CI integration."
},
"coverage": null,
"created_at": "2016-01-11T10:13:33.506Z",
"download_url": null,
"finished_at": null,
"id": 69,
"name": "rubocop",
"ref": "master",
"runner": null,
"stage": "test",
"started_at": null,
"status": "pending",
"tag": false,
"user": null
}