Avatar ID

Overview

The Avatar ID is a unique string identifier prefixed with avt_ (e.g., avt_9f8a2b3c4d) that uniquely represents a published character configuration.

Finding Your Avatar ID

• In the dashboard: Navigate to Avatars, click your avatar, and copy the ID from the top header badge.

• In the URL: https://asiyst.com/dashboard/avatars/avt_9f8a2b3c4d

• Via CLI: Run asiyst avatar list.

Using Avatar ID in the SDK

If you have multiple published avatars and want to switch characters dynamically at runtime:

import { Asiyst } from "@asiyst/sdk";
// Switch avatar character based on current route or user role
if (window.location.pathname.startsWith("/developers")) {
  Asiyst.setAvatar("avt_developer_guide_123");
} else {
  Asiyst.setAvatar("avt_sales_bot_456");
}