---
title: "Create Avatar"
method: POST
path: "/account/presenter-avatars"
tags: ["account"]
---

# Create Avatar

`POST /account/presenter-avatars`

## Request

- Base URL: `https://api.beatra.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.beatra.ai/account/presenter-avatars`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Request body

- AvatarCreateRequest
  - `artifact_id` string, required
  - `display_name` string, required
  - `purpose` string, nullable
  - `voice_id` string, nullable
  - `make_default` boolean
  - `consent_attested` true, required
  - `consent_subject` 'self' | 'authorized_other', required

## Response `201`

Successful Response

- AvatarItem
  - `avatar_id` string, required
  - `display_name` string, required
  - `purpose` string, nullable, required
  - `image` ImageItem, required
    - `artifact_id` string, required
    - `url` string, nullable, required
    - `mime_type` string, required
    - `width` integer, nullable, required
    - `height` integer, nullable, required
  - `voice` AvatarVoice, required
    - `voice_id` string, required
    - `display_name` string, required
  - `is_default` boolean, required
  - `created_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/beatra/apis/agent-service-api.md) · [All operations](https://skmtc.dev/beatra/apis/agent-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/beatra/apis/agent-service-api/revisions/58e440556498?raw)