# Upload account avatar

**POST /api/my-account/user-assets/avatar**

Upload a single avatar image to the configured storage provider and return the public URL of the uploaded asset. Requires the `profile` scope and the `avatar` field to be editable in the account center configuration. The returned URL can then be used as the value for the avatar field via `PATCH /api/my-account`.


## Servers
- Logto endpoint address.: https://[tenant_id].logto.app (Logto endpoint address.)


## Authentication methods
- O auth2


## Parameters



### Body: multipart/form-data (object)

- **file** ()
  The avatar image file to upload. Must be an allowed image type and not exceed the maximum upload file size.


## Responses
### 200
The asset was uploaded successfully.

#### Body: application/json (object)
- **url** (string)


### 400
The request is invalid (e.g. file too large, image type not allowed, storage is not configured, or the avatar field is not editable).

### 401
Permission denied, the access token does not include the `profile` scope.

### 403
Permission denied for the current account center state.

### 500
Failed to upload the file to the storage provider.


[Powered by Bump.sh](https://bump.sh)