---
title: "Changes to create avatar"
method: POST
path: "/v1/avatars"
---

# Changes to create avatar

`POST /v1/avatars`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 48 revisions.

- **2026-11-02** `eb37272f87e5`: 2 warning, 1 info
- **2026-10-28** `2aa7f658bda1`: 2 info
- **2026-10-26** `13412bd20843`: 1 info
- **2026-10-26** `9bf283e41c4c`: 1 warning, 1 info
- **2026-10-26** `e85ef0cd491e`: 4 breaking
- **2026-10-20** `da84071722c5`: 2 info
- **2026-10-05** `3fb577bf1a21`: 1 info
- **2026-09-18** `450b7bc2c11f`: 2 breaking, 4 info
- **2026-09-15** `c89509d87918`: 1 info
- **2026-09-15** `fc803469630d`: 2 info
- **2026-09-11** `0086e7b3fc3f`: 1 breaking, 1 warning, 3 info
- **2026-09-11** `28a19f45f80c`: 1 info
- **2026-08-04** `7af8ef78a410`: 1 breaking, 7 info

## Changes

- **2026-11-02** `eb37272f87e5`: 2 warning, 1 info
  - added the new `image_unprocessable` enum value to the `code` response property for the response status `422`
  - added the new `moderation_blocked` enum value to the `code` response property for the response status `422`
  - the response property `code` became required for the status `422`
- **2026-10-28** `2aa7f658bda1`: 2 info
  - added the new optional request property `imageProcessing` (media type: multipart/form-data)
  - added the new optional request property `imageProcessing` (media type: application/json)
- **2026-10-26** `13412bd20843`: 1 info
  - added the optional property `rateLimit/upgrade` to the response with the `429` status
- **2026-10-26** `9bf283e41c4c`: 1 warning, 1 info
  - added the new `worker_failed` enum value to the `code` response property for the response status `502`
  - the response property `code` became required for the status `502`
- **2026-10-26** `e85ef0cd491e`: 4 breaking
  - added `#/components/schemas/ServiceUnavailableError, subschema #1` to the response body `oneOf` list for the response status `503`
  - the response's body type changed from `object` to no type for status `503`
  - removed the required property `code` from the response with the `503` status
  - removed the required property `error` from the response with the `503` status
- **2026-10-20** `da84071722c5`: 2 info
  - added the new `cara-4.1-express` enum value to the request property `avatarModel` (media type: multipart/form-data)
  - added the new `cara-4.1-express` enum value to the request property `avatarModel` (media type: application/json)
- **2026-10-05** `3fb577bf1a21`: 1 info
  - added the optional property `sourceImageUrl` to the response with the `201` status
- **2026-09-18** `450b7bc2c11f`: 2 breaking, 4 info
  - request property `avatarModel` was restricted to a list of enum values (media type: multipart/form-data)
  - request property `avatarModel` was restricted to a list of enum values (media type: application/json)
  - added the new `cara-4` enum value to the request property `avatarModel` (media type: multipart/form-data)
  - added the new `cara-4` enum value to the request property `avatarModel` (media type: application/json)
  - added the new `cara-4-latest` enum value to the request property `avatarModel` (media type: multipart/form-data)
  - added the new `cara-4-latest` enum value to the request property `avatarModel` (media type: application/json)
- **2026-09-15** `c89509d87918`: 1 info
  - added the media type `application/json` for the response with the status `400`
- **2026-09-15** `fc803469630d`: 2 info
  - added the media type `application/json` for the response with the status `422`
  - added the optional property `code` to the response with the `502` status
- **2026-09-11** `0086e7b3fc3f`: 1 breaking, 1 warning, 3 info
  - the response property `rateLimit` became optional for the status `429`
  - added the new `CREATION_BUSY` enum value to the `code` response property for the response status `429`
  - added the non-success response with the status `409`
  - added the non-success response with the status `502`
  - added the non-success response with the status `503`
- **2026-09-11** `28a19f45f80c`: 1 info
  - added the media type `application/json` for the response with the status `429`
- **2026-08-04** `7af8ef78a410`: 1 breaking, 7 info
  - the response property `activeVersion` became nullable for the status `201`
  - added the non-success response with the status `429`
  - added the optional property `description` to the response with the `201` status
  - added the optional property `displayTags` to the response with the `201` status
  - added the optional property `idleVideoUrl` to the response with the `201` status
  - added the optional property `landscapeImageUrl` to the response with the `201` status
  - added the optional property `portraitImageUrl` to the response with the `201` status
  - added the optional property `renderStyle` to the response with the `201` status

---

[Operation](https://skmtc.dev/anam/apis/anam-ai-api/docs/v1/avatars/post.md) - [API](https://skmtc.dev/anam/apis/anam-ai-api.md) - [Page](https://skmtc.dev/anam/apis/anam-ai-api/changes/v1/avatars/post)