---
title: "POST /v0.1/apps/{owner_name}/{app_name}/avatar"
method: POST
path: "/v0.1/apps/{owner_name}/{app_name}/avatar"
tags: ["account"]
---

# POST /v0.1/apps/{owner_name}/{app_name}/avatar

`POST /v0.1/apps/{owner_name}/{app_name}/avatar`

## Request

- Base URL: `https://api.appcenter.ms`
- URL: `https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/avatar`
- 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/avatar/post.ts> (a function with typed inputs; its response is checked against the schema)

Sets the app avatar

## Path parameters

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

## Request body `multipart/form-data`

- object
  - `avatar` string, binary: The image for an app avatar to upload.

## Response `200`

Success

- object
  - `id` string, uuid, required: The unique ID (UUID) of the app
  - `description` string: The description of the app
  - `display_name` string, required: The display name of the app
  - `release_type` string: A one-word descriptive release-type value that starts with a capital letter but is otherwise lowercase
  - `icon_url` string: The string representation of the URL pointing to the app's icon
  - `icon_source` string: The string representation of the source of the app's icon
  - `name` string, required: The name of the app used in URLs
  - `os` 'Android' | 'iOS' | 'macOS' | 'Tizen' | 'tvOS' | 'Windows' | 'Linux' | 'Custom', required: The OS the app will be running on
  - `owner` object, required: The information about the app's owner
    - `id` string, uuid, required: The unique id (UUID) of the owner
    - `avatar_url` string: The avatar URL of the owner
    - `display_name` string, required: The owner's display name
    - `email` string: The owner's email address
    - `name` string, required: The unique name that used to identify the owner
    - `type` 'org' | 'user', required: The owner type. Can either be 'org' or 'user'
  - `app_secret` string, required: A unique and secret key used to identify the app in communication with the ingestion endpoint for crash reporting and analytics
  - `azure_subscription` object
    - `subscription_id` string, uuid, required: The azure subscription id
    - `tenant_id` string, uuid, required: The tenant id of the azure subscription belongs to
    - `subscription_name` string, required: The name of the azure subscription
    - `is_billing` boolean: If the subscription is used for billing
    - `is_billable` boolean: If the subscription can be used for billing
    - `is_microsoft_internal` boolean: If the subscription is internal Microsoft subscription
  - `platform` 'Java' | 'Objective-C-Swift' | 'UWP' | 'Cordova' | 'React-Native' | 'Unity' | 'Electron' | 'Xamarin' | 'WPF' | 'WinForms' | 'Unknown' | 'Custom', required: The platform of the app
  - `origin` 'appcenter' | 'hockeyapp' | 'codepush', required: The creation origin of this app
  - `created_at` string: The created date of this app
  - `updated_at` string: The last updated date of this app
  - `member_permissions` string[]: The permissions of the calling user

## Other responses

- `default`: Error

---

[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)