---
title: "Patch Avatar"
method: PATCH
path: "/account/presenter-avatars/{avatar_id}"
tags: ["account"]
---

# Patch Avatar

`PATCH /account/presenter-avatars/{avatar_id}`

## 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/{avatar_id}`
- Auth: none declared

## Path parameters

- `avatar_id` string, required

## Headers

- `authorization` string, nullable

## Request body

- AvatarPatchRequest: Leave a field out to keep it; null clears the use or the paired voice.
  - `display_name` string, nullable
  - `purpose` string, nullable
  - `voice_id` string, nullable

## Response `200`

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)