Sign in
Build

List builds

Lists builds for an application.

get/build

Query parameters

offsetinteger

The starting point for pagination. Defaults to 0 if not provided.

limitinteger

The maximum number of results to return per page.

application_idinteger required

The ID of the application to filter by.

status'pending' | 'in_progress' | 'failed' | 'successful'

The status of the build.

commit.idstring

The commit ID of the build.

Response

A list of builds.

Example response

[
  {
    "paging": {
      "total": 30,
      "limit": 200
    },
    "results": [
      {
        "id": 123,
        "application_id": 345,
        "branch": "main",
        "commit": {
          "id": "123abc",
          "permalink": "https://example.com/1234"
        },
        "created_at": "2021-01-01T00:00:00Z",
        "updated_at": "2021-01-02T00:00:00Z",
        "description": "This is a description of the build.",
        "nrn": "organization=1:account=2:namespace=3:application=234:build=123",
        "status": "pending"
      }
    ]
  }
]

Changes