Show the latest build

{
  "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"
}

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 are cancelled, failed, queued, running, or success. 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?

Parameters

Required = *

Placeholder for the endpoint parameters; auto-generated from JSON above.

curl
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:'
jquery
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);
});
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"
      }
    ]
  }
}

results matching ""

    No results matching ""