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

# avatar.added

Confirms that an `avatar.add` event was accepted and that the new avatars are available to select with `session.update`.

## Event fields

<ResponseField name="event_id" type="string" required>
  Unique id for this server event.
</ResponseField>

<ResponseField name="type" type="string" required>
  Event type. Must be `avatar.added`.
</ResponseField>

<ResponseField name="avatars" type="array" required>
  Avatars registered by the accepted event.
</ResponseField>

<ResponseField name="avatars[].avatar_id" type="string" required>
  Registered avatar id.
</ResponseField>

**`avatars[].instructions`, voice, visual: optional fields**

Effective avatar definition accepted by the service.

<ResponseExample>
  ```json avatar.added theme={null}
  {
    "event_id": "evt_avatar_added_001",
    "type": "avatar.added",
    "avatars": [
      {
        "avatar_id": "host_c",
        "instructions": "You are Host C, a practical product specialist.",
        "visual": {
          "source_images": [
            {
              "source_image_id": "front",
              "url": "https://api.vivix.ai/host-c-front.png",
              "description": "A man facing the camera in a brightly lit studio, front view.",
              "media_type": "image/png"
            }
          ],
          "default_source_image_id": "front"
        }
      }
    ]
  }
  ```
</ResponseExample>