---
title: "Add a platform asset to a release"
method: POST
path: "/v1/releases/{releaseId}/assets"
tags: ["releases"]
---

# Add a platform asset to a release

`POST /v1/releases/{releaseId}/assets`

## Request

- Base URL: `https://api.ditto.audio` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ditto.audio/v1/releases/{releaseId}/assets`
- Auth: HTTP bearer

## Path parameters

- `releaseId` string, required

## Request body

- CreateReleaseAssetDto
  - `platform` string, required: Target platform
  - `arch` string
  - `fileName` string, required
  - `fileSize` number: File size in bytes
  - `sha256` string: SHA-256 hash for integrity
  - `downloadUrl` string, required: Absolute download URL or relative path (combined with assetBaseUrl)
  - `mimeType` string
  - `signature` string: Sparkle/EdDSA signature for macOS auto-update

## Response `201`

---

[API](https://skmtc.dev/ditto/apis/ditto-audio-api.md) · [All operations](https://skmtc.dev/ditto/apis/ditto-audio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ditto/apis/ditto-audio-api/revisions/30c8d7c218da?raw)
