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

# List All Avatars

> Fetch a list of stock avatars that are available to be used as the face for your agents.



## OpenAPI

````yaml GET /ext/avatars
openapi: 3.0.3
info:
  title: TruGen Developer Platform API
  version: 1.0.0
  description: OpenAPI specification for MCP endpoint
servers:
  - url: https://api.trugen.ai/v1
security: []
paths:
  /ext/avatars:
    get:
      summary: Get all avatars
      description: >-
        Fetch a list of stock avatars that are available to be used as the face
        for your agents.
      responses:
        '200':
          description: List of all available avatars
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    avatar_key_id:
                      type: string
                      description: >-
                        A unique ID for the avatar, this will be used while
                        creating new agent.
                      example: ed3a666dc5
                    avatar_name:
                      type: string
                      description: >-
                        Default name of the stock avatar (This can be changed by
                        setting a new name in the system prompt).
                      example: Lisa
                    gender:
                      type: string
                      example: male
                    display_picture:
                      type: string
                      example: >-
                        data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEASABIAAD/4gHYSUNDX1BST0ZJTEUAAQEA
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````