{ "base": "\https://api.buddybuild.com/v1", "endpoint": "/apps/:app_id:/builds/latest", "method": "get", "params": { "headers": [ { "name": "Authorization", "type": "Bearer :api-access-token:", "req": true, "cue": "Enter your API access token" } ], "path": [ { "name": ":app_id:", "type": "string", "desc": 'App identifier', "req": true, "cue": 'Enter an app id' } ], "query": [ { "name": "branch", "type": "string", "desc": "URL-encoded name of the branch", "req": false, "cue": "Enter a branch name" }, { "name": "scheme", "type": "string", "desc": "URL-encoded name of the scheme (iOS only)", "req": false, "cue": "Enter a scheme name" }, { "name": "status", "type": "string", "desc": 'One of "cancelled", "failed", "queued", "running", "success"', "req": false, "cue": 'Enter a status, one "of "cancelled", "failed", "queued", "running", "success"' } ], "body": [] }, "authentication": "required" }
Show the latest build
Definition
Placeholder for the definition; auto-generated from JSON above.
Use this method to show the most recent build for the specified app.
You can apply optional filters to the query:
-
Specify a branch name (
branch
) to get the most recent build for the specified branch. The branch name must be URL encoded. -
Specify a build status (
status
) to get the most recent build for the specified build status. Valid values arecancelled
,failed
,queued
,running
, orsuccess
. Use this to get the most recent successful build for example.
For iOS apps, you can also apply the optional scheme filter to the query:
-
Each build of a multi-scheme build is returned separately. Specify an iOS scheme name (
scheme
) to restrict the output to the most recent build for the specified scheme. The scheme name must be URL encoded.
Note
|
Looking for your API access token? Read more about authenticating with buddybuild or show your personal access token. |
Parameters
Required = *
Placeholder for the endpoint parameters; auto-generated from JSON above.
curl -X GET \
-H 'Authorization: Bearer :api-access-token:' \
'https://api.buddybuild.com/v1/apps/:app_id:/builds/latest?branch=:branch_id:&scheme=:scheme:&status=:status:'
var settings = {
"async": true,
"crossDomain": true,
"url": "https://api.buddybuild.com/v1/apps/:app_id:/builds/latest?branch=:branch_id:&scheme=:scheme:&status=:status:",
"method": "GET",
"headers": {
"authorization": "Bearer :api-access-token:"
}
}
$.ajax(settings).done(function (response) {
console.log(response);
});
{
"_id": "58b899061baced0100616172",
"app_id": "58b897fb1baced010061616e",
"repo_url": "git@github.com:myorg/2048.git",
"build_status": "failed",
"finished": true,
"commit_info": {
"tags": [],
"branch": "master",
"commit_sha": "54a9faeccc0979aaa16f3226562a24fb3330e9f0",
"author": "David Pie",
"message": "Add new crash type",
"html_url": "https://github.com/myorg/2048/commit/54a9faeccc0979aaa16f3226562a24fb3330e9f0"
},
"build_number": 2,
"created_at": "2017-03-02T22:13:26.728Z",
"started_at": "2017-03-02T22:15:11.381Z",
"finished_at": "2017-03-02T22:20:06.432Z",
"test_summary": {
"tests_count": 10,
"tests_passed": 9,
"code_coverage_percentage": 0.6878079796534735
},
"links": {
"download": [
{
"name": "m2048 - Release",
"url": "https://dashboard.buddybuild.com/api/download/download-ipa?buildID=58b899061baced0100616172"
}
],
"install": [
{
"name": "m2048 - Release",
"url": "https://dashboard.buddybuild.com/download/ios?buildID=58b899061baced0100616172"
}
]
}
}