---
title: "Delete a build"
method: DELETE
path: "/app/{appId}/bucket/{bucketId}/build/{buildDistroBuildId}"
tags: ["buildDistro"]
---

# Delete a build

`DELETE /app/{appId}/bucket/{bucketId}/build/{buildDistroBuildId}`

## Request

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

## Path parameters

- `appId` string, required
- `bucketId` string, required
- `buildDistroBuildId` string, required

## Response `200`

A Build Distro build response

- BuildDistroBuildEntity
  - `buildId` string, required: The id of the Build Distro build
  - `status` 'active' | 'expired' | 'deleted', required
  - `bucketName` string, required: The name of the build's bucket
  - `bucketId` string, required: The ID of the build's bucket
  - `artifactFileName` string: The name of the artifact file associated with the build
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `additionalTesters` BuildDistroBuildTester[], required: Any additional users or user groups assigned as testers for the build. Bucket members of the bucket this build is in are not included in the additional testers list.
    - `type` 'user' | 'userGroup', required: The type of tester
    - `id` string, required: The ID of the user or user group
  - `testerNotes` string: Optional tester notes for the build
  - `downloadURL` string: The url to download the build. The request to this URL must be authenticated with a Runway API key.
  - `ciBuildInfo` CIBuildEntity
    - `buildHash` string, required: A unique identifier for the build from a CI system, generated from the combination of integrationId and build identifier
    - `buildIdentifier` string, 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
    - `buildUrl` string, required: The URL to the build in the CI system
    - `buildStartedAt` string, date-time, required: The start date and time of the build
    - `buildFinishedAt` string, 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`.
    - `providerBuildStatusString` string: The status string displayed to the user from the provider
    - `commit` string, required: The commit hash that triggered the build
    - `commitMessage` string: The commit message associated with the commit hash that triggered the build
    - `commitAuthor` string: The author of the commit that triggered the build
    - `commitUrl` string: The URL to the commit in the version control system
    - `workflowName` string: The displayable name of the workflow
    - `branchName` string, required: The branch name the build was triggered from
    - `workflowRunIdOrCommaDelimitedIds` string: The workflow run ID(s) associated with this build. Can be a single ID or comma-delimited list of IDs
  - `binaryBuildNumber` string: The build number found associated to the binary artifact
  - `binaryBuildVersion` string: The build version found associated to the binary artifact
  - `binaryBuildType` string: The type of binary artifact
  - `additionalArtifacts` BuildDistroAdditionalArtifact[], required: Additional artifacts for the build
    - `fileName` string, required: The name of the file
    - `size` number, required: The file's size in bytes
    - `downloadUrl` string, required: The file's download URL. Requests to this URL must be authenticated with a Runway API key.

## Other responses

- `404`: Resource not found response

---

[API](https://skmtc.dev/runway/apis/runway-rest-api.md) - [All operations](https://skmtc.dev/runway/apis/runway-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runway/apis/runway-rest-api/revisions/081109863a9a?raw)