# List avatars

div
strong
🔨 In Development
 — This section is still being developed and may change.


Get a list of all predefined avatars available for assistants and user profiles.

Returns a collection of predefined avatar images that can be used for assistants and user profiles. Each avatar includes a preview URL and metadata.

## Returns

An array of [Avatar objects](/docs/api-reference/objects/avatar-object).


```bash
curl "https://api.freddy.aitronos.com/v1/avatars" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/avatars",
    headers={"Authorization": f"Bearer {api_key}"}
)

avatars = response.json()
print(f"Found {len(avatars)} avatars")
for avatar in avatars:
    print(f"- {avatar['name']}: {avatar['url']}")
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/avatars', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const avatars = await response.json();
console.log(`Found ${avatars.length} avatars`);
avatars.forEach(avatar => {
  console.log(`- ${avatar.name}: ${avatar.url}`);
});
```

## Response

200 OK

```json
[
  {
    "id": "avt_robot_blue",
    "name": "Blue Robot",
    "url": "https://cdn.aitronos.com/avatars/robot-blue.png",
    "previewUrl": "https://cdn.aitronos.com/avatars/previews/robot-blue-thumb.png",
    "category": "robots",
    "tags": ["robot", "blue", "tech", "ai"],
    "size": {
      "width": 512,
      "height": 512
    }
  },
  {
    "id": "avt_assistant_purple",
    "name": "Purple Assistant",
    "url": "https://cdn.aitronos.com/avatars/assistant-purple.png",
    "previewUrl": "https://cdn.aitronos.com/avatars/previews/assistant-purple-thumb.png",
    "category": "assistants",
    "tags": ["assistant", "purple", "friendly"],
    "size": {
      "width": 512,
      "height": 512
    }
  },
  {
    "id": "avt_professional_teal",
    "name": "Teal Professional",
    "url": "https://cdn.aitronos.com/avatars/professional-teal.png",
    "previewUrl": "https://cdn.aitronos.com/avatars/previews/professional-teal-thumb.png",
    "category": "professional",
    "tags": ["professional", "teal", "business"],
    "size": {
      "width": 512,
      "height": 512
    }
  },
  {
    "id": "avt_creative_orange",
    "name": "Orange Creative",
    "url": "https://cdn.aitronos.com/avatars/creative-orange.png",
    "previewUrl": "https://cdn.aitronos.com/avatars/previews/creative-orange-thumb.png",
    "category": "creative",
    "tags": ["creative", "orange", "artistic"],
    "size": {
      "width": 512,
      "height": 512
    }
  },
  {
    "id": "avt_support_green",
    "name": "Green Support",
    "url": "https://cdn.aitronos.com/avatars/support-green.png",
    "previewUrl": "https://cdn.aitronos.com/avatars/previews/support-green-thumb.png",
    "category": "support",
    "tags": ["support", "green", "helpful"],
    "size": {
      "width": 512,
      "height": 512
    }
  }
]
```

Errors
**401 Unauthorized**


```json
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing authentication token",
    "trace_id": "trace_abc123"
  }
}
```

## Avatar Categories

Avatars are organized into the following categories:

- **robots** - Robot and AI-themed avatars
- **assistants** - Friendly assistant characters
- **professional** - Business and professional avatars
- **creative** - Artistic and creative avatars
- **support** - Customer support themed avatars
- **technical** - Developer and technical avatars
- **abstract** - Abstract and geometric designs


## Usage

To use an avatar with an assistant:


```json
{
  "name": "My Assistant",
  "avatarId": "avt_robot_blue",
  "model": "ftg-3.0"
}
```

You can also use a custom avatar URL instead:


```json
{
  "name": "My Assistant",
  "avatar": "https://example.com/my-custom-avatar.png",
  "model": "ftg-3.0"
}
```

## Related Resources

- [Create Assistant](/docs/api-reference/assistants/create)
- [Update Assistant](/docs/api-reference/assistants/update)
- [Avatar Object](/docs/api-reference/objects/avatar-object)