RUrunway
buildDistro

Get a bucket's builds

get/app/{appId}/bucket/{bucketId}/builds

Request

  • Base URL
    https://api.runway.team
  • URL
    https://api.runway.team/app/{appId}/bucket/{bucketId}/builds
  • Auth
    API key in header X-API-Key

Path parameters

appIdstring required

The id of the app

bucketIdstring required

The id of the bucket

Query parameters

limitinteger

For pagination, the maximum number of builds to return

offsetinteger

For pagination, the number of builds to skip before returning the first release

Response

A Build Distro build response

buildIdstring required

The id of the Build Distro build

status'active' | 'expired' | 'deleted' required
bucketNamestring required

The name of the build's bucket

bucketIdstring required

The ID of the build's bucket

artifactFileNamestring

The name of the artifact file associated with the build

createdAtstring date-time required
updatedAtstring date-time required
testerNotesstring

Optional tester notes for the build

downloadURLstring

The url to download the build. The request to this URL must be authenticated with a Runway API key.

binaryBuildNumberstring

The build number found associated to the binary artifact

binaryBuildVersionstring

The build version found associated to the binary artifact

binaryBuildTypestring

The type of binary artifact

Example response

[
  {
    "buildId": "12345",
    "bucketName": "CIs",
    "bucketId": "abc123",
    "artifactFileName": "my-app.ipa",
    "createdAt": "2022-03-02T01:15:00Z",
    "updatedAt": "2022-03-02T01:15:00Z",
    "downloadURL": "https://api.runway.team/v1/app/my-app/bucket/my-bucket/build/my-build/download",
    "ciBuildInfo": {
      "buildHash": "abc123def456",
      "buildIdentifier": "123",
      "buildUrl": "https://ci.example.com/build/123",
      "buildStartedAt": "2022-03-02T01:15:00Z",
      "buildFinishedAt": "2022-03-02T01:20:00Z",
      "providerBuildStatusString": "In progress",
      "commit": "abcdef123456",
      "commitMessage": "Fix bug in authentication",
      "commitAuthor": "John Doe",
      "commitUrl": "https://github.com/org/repo/commit/abcdef123456",
      "workflowName": "CI Build",
      "branchName": "main",
      "workflowRunIdOrCommaDelimitedIds": "workflow-run-123"
    },
    "binaryBuildNumber": "12345",
    "binaryBuildVersion": "1.2.3",
    "binaryBuildType": "ipa",
    "additionalArtifacts": [
      {
        "fileName": "test_results.html",
        "size": 1048576,
        "downloadUrl": "https://api.runway.team/v1/app/my-app/bucket/my-bucket/build/my-build/additionalFiles/test_results.html"
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.