> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agenthuman.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Avatar Object

> Schema definition for Avatar objects returned by the API

## Overview

An **Avatar** represents a pre-built or user-uploaded avatar image available for use in sessions and agents. Each avatar exposes both a square preview URL and a full-resolution image URL.

## Fields

<ResponseField name="avatar_id" type="string">
  Unique identifier for the avatar (e.g. `PUBLIC/Avatars/sara-office`). Pass this as `avatar_id` to [Preview Avatar](/api-reference/endpoints/preview-avatar) or as `avatar_image_url` in sessions and agents.
</ResponseField>

<ResponseField name="tags" type="array">
  Array of tags associated with the avatar.
</ResponseField>

<ResponseField name="preview_url" type="string">
  Signed URL at 500×500 px, suitable for display in a picker UI.
</ResponseField>

<ResponseField name="image_url" type="string">
  Signed URL of the full-resolution avatar (capped at 1200 px wide). Use this as `avatar_image_url` in sessions or agents.
</ResponseField>

## Example

```json theme={null}
{
  "avatar_id": "PUBLIC/Avatars/sara-office",
  "tags": ["female", "professional"],
  "preview_url": "https://cdn.agenthuman.com/avatars/sara-office/preview",
  "image_url": "https://cdn.agenthuman.com/avatars/sara-office/image"
}
```