---
title: "Post Agent Avatar"
method: POST
path: "/v1/convai/agents/{agent_id}/avatar"
tags: ["Agents Platform"]
---

# Post Agent Avatar

`POST /v1/convai/agents/{agent_id}/avatar`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/convai/agents/{agent_id}/avatar`
- Auth: none declared

Sets the avatar for an agent displayed in the widget

## Path parameters

- `agent_id` string, required: The id of an agent. This is returned on agent creation.

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body `multipart/form-data`

- BodyPostAgentAvatarV1ConvaiAgentsAgentIdAvatarPost
  - `avatar_file` string, binary, required: An image file to be used as the agent's avatar.

## Response `200`

Successful Response

- PostAgentAvatarResponseModel
  - `agent_id` string, required
  - `avatar_url` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-02-08** `5b595807512c`: 3 info
  - api operation id `Post_Agent_avatar_v1_convai_agents__agent_id__avatar_post` removed and replaced with `post_agent_avatar_route`
  - api tag `Agents Platform` added
  - api tag `Conversational AI` removed
- **2025-05-16** `503db4198a44`: 1 breaking, 2 info
  - response property `avatar_url` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - `header` request parameter `xi-api-key` list-of-types was widened by adding types `null`
  - for the `header` request parameter `xi-api-key`, the type was generalized from `string` to no type
- **2024-11-22** `dd10bbb98a6e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/agents/:agent_id/avatar/post.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/d04f5e77c40a?raw)