> ## 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.

# List Avatars

> Get public avatars and your own uploaded avatars in one request

Returns the full library of pre-built public avatars alongside any avatars you have uploaded yourself.

Use `image_url` from either list as the `avatar_image_url` when creating sessions or agents or pass the `avatar_id` to [Preview Avatar](/api-reference/endpoints/preview-avatar).

### Response

<ResponseField name="success" type="boolean">
  Whether the request was successful.
</ResponseField>

<ResponseField name="public_avatars" type="array">
  Array of [Avatar](/api-reference/schemas/avatar) objects available to all users.
</ResponseField>

<ResponseField name="my_avatars" type="array">
  Array of [Avatar](/api-reference/schemas/avatar) objects you have uploaded or generated.
</ResponseField>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "success": true,
    "public_avatars": [
      {
        "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"
      }
    ],
    "my_avatars": [
      {
        "avatar_id": "avat_01J8ZK4R2N5M6P7Q8W4T",
        "tags": ["user_exclusive", "user_42"],
        "preview_url": "https://cdn.agenthuman.com/avatars/avat_01J8ZK4R2N5M6P7Q8W4T/preview",
        "image_url": "https://cdn.agenthuman.com/avatars/avat_01J8ZK4R2N5M6P7Q8W4T/image"
      }
    ]
  }
  ```

  ```json 401 - Unauthorized theme={null}
  {
    "success": false,
    "error": {
      "message": "Unauthorized"
    }
  }
  ```
</ResponseExample>