RUrunway
app

List builds for a 'Custom CI' integration on a release

Lists builds uploaded to a Custom CI (Mobile Release Management / MRM) integration for a specific release. Use this to discover the buildHash for a build (e.g. to download its artifact). Only supported for integrations of type customCI — for other CI providers (Bitrise, CircleCI, etc.) builds are fetched directly from the provider and are not listed here. Results are sorted newest first.

get/app/{appId}/integration/{integrationInstallationId}/build

Request

  • Base URL
    https://api.runway.team
  • URL
    https://api.runway.team/app/{appId}/integration/{integrationInstallationId}/build
  • Auth
    API key in header X-API-Key

Path parameters

appIdstring required

The id of the app

integrationInstallationIdstring required

The unique installation ID for the integration. Found in the corresponding integration settings in Runway. Has the format <integration type>:<random string>, for example custom-ci:d5onv9mfdkkqlsl3cie0.

Query parameters

versionstring required

The release's version string (e.g. 5.12.0).

Response

List of builds uploaded to the integration for the given release, sorted newest first.

buildHashstring required

A unique identifier for the build from a CI system, generated from the combination of integrationId and build identifier

buildIdentifierstring required

The identifier of the build as set by the integration provider

integrationId'amazon' | 'apple' | 'google' | 'huawei' | 'samsung' | 'expo-eas' | 'appcenter-beta' | 'apple-beta' | 'google-beta' | 'firebase-beta' | 'runway-build-distro-beta' | 'appcenter-ci' | 'apple-ci' | 'azure-ci' | 'bitrise' | 'buildkite' | 'circleci' | 'codemagic' | 'generic-ci' | 'github-ci' | 'gitlab-ci' | 'jenkins' | 'travis' | 'launchdarkly' | 'optimizely' | 'statsig' | 'firebase-remote-config' | 'amplitude-experiment' | 'unleash' | 'asana' | 'azure-it' | 'jira' | 'linear' | 'pivotal' | 'shortcut' | 'monday' | 'slack' | 'microsoft-teams' | 'amplitude' | 'datadog-analytics' | 'mixpanel-analytics' | 'google-analytics' | 'apple-power-performance-metrics' | 'new-relic-analytics' | 'custom-analytics' | 'testrail' | 'qase' | 'testmo' | 'browserstack' | 'xray' | 'bugsnag' | 'firebase' | 'sentry' | 'embrace-stability-monitoring' | 'datadog-stability-monitoring' | 'dynatrace-stability-monitoring' | 'new-relic-stability-monitoring' | 'luciq-stability-monitoring' | 'luciq-analytics' | 'github-vcs-dist' | 'bitbucket' | 'github' | 'gitlab-vcs' | 'azure-vcs' | 'pagerduty-scheduling' | 'incident-io-scheduling' | 'opsgenie-scheduling' | 'crowdin' | 'lokalise' | 'jira-service-management-scheduling' required

The type of integration

buildUrlstring required

The URL to the build in the CI system

buildStartedAtstring date-time required

The start date and time of the build

buildFinishedAtstring date-time

The end date and time of the build

buildStatus'inProgress' | 'stopped' | 'success' | 'failure' | 'skipped' required

The status of the CI build. When passing build info as part of an artifact upload, this value should always be success.

providerBuildStatusStringstring

The status string displayed to the user from the provider

commitstring required

The commit hash that triggered the build

commitMessagestring

The commit message associated with the commit hash that triggered the build

commitAuthorstring

The author of the commit that triggered the build

commitUrlstring

The URL to the commit in the version control system

workflowNamestring

The displayable name of the workflow

branchNamestring required

The branch name the build was triggered from

workflowRunIdOrCommaDelimitedIdsstring

The workflow run ID(s) associated with this build. Can be a single ID or comma-delimited list of IDs

Example response

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

Changes

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