---
title: "POST /avatar"
method: POST
path: "/avatar"
tags: ["avatar"]
---

# POST /avatar

`POST /avatar`

Avatars are public images used to represent you or your company. Avatars are used to represent users, monetary accounts and cash registers. Avatars cannot be deleted, only replaced. Avatars can be updated after uploading the image you would like to use through AttachmentPublic. Using the attachment_public_uuid which is returned you can update your Avatar. Avatars used for cash registers and company accounts will be reviewed by bunq.

## Headers

- `Cache-Control` string
- `User-Agent` string, required
- `X-Bunq-Language` string
- `X-Bunq-Region` string
- `X-Bunq-Client-Request-Id` string
- `X-Bunq-Geolocation` string
- `X-Bunq-Client-Authentication` string, required

## Request body

- Avatar
  - `uuid` string — The public UUID of the avatar.
  - `anchor_uuid` string — The public UUID of object this avatar is anchored to.
  - `image` Image[] — The actual image information of this avatar.
    - `attachment_public_uuid` string — The public UUID of the public attachment containing the image.
    - `content_type` string — The content-type as a MIME filetype.
    - `height` integer — The image height in pixels.
    - `width` integer — The image width in pixels.
  - `style` string — The style (if applicable) for this Avatar.

## Response `200`

Avatars are public images used to represent you or your company. Avatars are used to represent users, monetary accounts and cash registers. Avatars cannot be deleted, only replaced. Avatars can be updated after uploading the image you would like to use through AttachmentPublic. Using the attachment_public_uuid which is returned you can update your Avatar. Avatars used for cash registers and company accounts will be reviewed by bunq.

- AvatarCreate
  - `uuid` string — The UUID of the created avatar.

## Other responses

- `400` — This is how the error response looks like for 4XX response codes

---

[API](https://skmtc.net/bunq/apis/bunq-api.md) · [All operations](https://skmtc.net/bunq/apis/bunq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bunq/bunq-api/revisions/369477c7bd26/schema)