---
title: "Changes to Create Avatar"
method: POST
path: "/v3/avatars"
---

# Changes to Create Avatar

`POST /v3/avatars`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `7dfa5e59b4f5`: 13 info

## Changes

- **2026-11-03** `7dfa5e59b4f5`: 13 info
  - added the new optional request property `oneOf[subschema #1: CreatePromptAvatarRequest]/aspect_ratio`
  - added `digital_twin, photo, prompt` mapping keys to the request discriminator
  - added `asset_id, base64, url` discriminator mapping keys to the `oneOf[subschema #1: CreatePromptAvatarRequest]/reference_images/anyOf[subschema #1]/items/` request property
  - added `asset_id, base64, url` discriminator mapping keys to the `oneOf[subschema #2: CreateDigitalTwinRequest]/file` request property
  - added `asset_id, base64, url` discriminator mapping keys to the `oneOf[subschema #3: CreatePhotoAvatarRequest]/file` request property
  - added the optional property `error/errors` to the response with the `400` status
  - added the optional property `error/errors` to the response with the `401` status
  - added the optional property `error/errors` to the response with the `409` status
  - added the optional property `error/errors` to the response with the `429` status
  - added the optional property `error/request_id` to the response with the `400` status
  - added the optional property `error/request_id` to the response with the `401` status
  - added the optional property `error/request_id` to the response with the `409` status
  - added the optional property `error/request_id` to the response with the `429` status

---

[Operation](https://skmtc.dev/heygen/apis/heygen-external-api/docs/v3/avatars/post.md) - [API](https://skmtc.dev/heygen/apis/heygen-external-api.md) - [Page](https://skmtc.dev/heygen/apis/heygen-external-api/changes/v3/avatars/post)