---
title: "Get avatars"
method: GET
path: "/avatar-profiles"
tags: ["Avatar Profiles"]
---

# Get avatars

`GET /avatar-profiles`

## Request

- Base URL: `https://api.mosaic.so`
- URL: `https://api.mosaic.so/avatar-profiles`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

List reusable AI Avatars from the organization's primary workspace.

## Response `200`

Avatar profiles

- object
  - `avatar_profiles` AvatarProfile[], required
    - `id` string, uuid, required: Avatar profile ID. Pass this as avatar_profile_id in an AI Avatar tile.
    - `video_preview_url` string, uri, nullable, required: Signed video preview URL. Null until a preview/reference video is available.
    - `name` string, required: Avatar display name.
    - `status` 'pending' | 'processing' | 'ready' | 'failed', required: Avatar processing state. Ready means fully prepared; pending/processing can be used while the run waits; failed cannot be used.
    - `status_message` string, nullable, required: Error message when status is failed; otherwise null.

## Other responses

- `401`: Authentication failed
- `403`: Access denied

---

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