---
title: "Delete release artifacts."
method: DELETE
path: "/apps/{appId}/releases/{releaseId}/artifacts"
tags: ["releases"]
---

# Delete release artifacts.

`DELETE /apps/{appId}/releases/{releaseId}/artifacts`

## Request

- Base URL: `https://api.shorebird.dev/api/v1`
- URL: `https://api.shorebird.dev/api/v1/apps/{appId}/releases/{releaseId}/artifacts`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Deletes the release's artifacts for one platform, or for every
platform when `platform` is omitted. This removes the stored
release artifacts and their records, the stored artifacts of the
release's patches for that platform, and the platform's entry in
the release's `platformStatuses`, so the platform no longer
appears on the release and its artifacts can be uploaded again.
Cached patch-check responses for the release version (and
platform) are cleared. The release itself and its patch records
are kept. Use `DELETE /apps/{appId}/releases/{releaseId}` to remove
the whole release.

Requires the `releases.delete` permission, which the `admin` and
`owner` roles hold. A "Release and patch only" API key does not.

## Query parameters

- `platform` 'android' | 'ios' | 'linux' | 'macos' | 'windows': A platform to which a Shorebird release can be deployed.

## Response `204`

The artifacts were deleted.

## Other responses

- `400`: The release id is not an integer (`release_id_malformed`), or the release does not belong to the app (`release_app_mismatch`).
- `403`: The caller lacks the `releases.delete` permission.
- `404`: The release does not exist (`release_not_found`).
- `424`: A storage, cache, or database step failed (`release_artifacts_delete_error`). Steps completed before the failure are not rolled back.
- `default`: Standard error response. Emitted for any non-2xx status where a body can be decoded into an [ErrorResponse].

---

[API](https://skmtc.dev/shorebird/apis/shorebird-codepush-api.md) - [All operations](https://skmtc.dev/shorebird/apis/shorebird-codepush-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shorebird/apis/shorebird-codepush-api/revisions/941da8871d10?raw)