---
title: "POST /v0.1/apps/{owner_name}/{app_name}/uploads/releases"
method: POST
path: "/v0.1/apps/{owner_name}/{app_name}/uploads/releases"
tags: ["distribute"]
---

# POST /v0.1/apps/{owner_name}/{app_name}/uploads/releases

`POST /v0.1/apps/{owner_name}/{app_name}/uploads/releases`

## Request

- Base URL: `https://api.appcenter.ms`
- URL: `https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/uploads/releases`
- Auth: API key in header `X-API-Token`
- TypeScript: <https://skmtc.dev/appcenter/apis/app-center-client/docs/v0.1/apps/:owner_name/:app_name/uploads/releases/post.ts> (a function with typed inputs; its response is checked against the schema)

Initiate a new release upload. This API is part of multi-step upload process.

## Path parameters

- `owner_name` string, required
- `app_name` string, required

## Request body

- object
  - `build_version` string: User defined build version
  - `build_number` string: User defined build number

## Response `201`

Created

- object
  - `id` string, uuid, required: The ID for the newly created upload. It is going to be required later in the process.
  - `upload_domain` string, required: The URL domain used to upload the release.
  - `token` string, required: The access token used for upload permissions.
  - `url_encoded_token` string, required: The access token used for upload permissions (URL encoded to use as a single query parameter).
  - `package_asset_id` string, uuid, required: The associated asset ID in the file management service associated with this uploaded.

## Other responses

- `400`: The request contained invalid properties.
- `404`: Error codes: - `not_found` - The app doesn't exist.

---

[API](https://skmtc.dev/appcenter/apis/app-center-client.md) - [All operations](https://skmtc.dev/appcenter/apis/app-center-client/llms.txt) - [OpenAPI document](https://skmtc.dev/appcenter/apis/app-center-client/revisions/4e9226ab8f35?raw)