---
title: "Get persona widget display configuration"
method: GET
path: "/v1/personas/{id}/widget"
tags: ["Personas"]
---

# Get persona widget display configuration

`GET /v1/personas/{id}/widget`

## Request

- Base URL: `https://api.anam.ai`
- URL: `https://api.anam.ai/v1/personas/{id}/widget`
- Auth: none required

Returns saved widget display configuration and avatar media. Origin access controls are omitted. Missing or temporarily unavailable idle previews are null; clients should show avatarImageUrl instead. Preview availability does not indicate whether the avatar can start a call.

## Path parameters

- `id` string, required

## Headers

- `Origin` string

## Response `200`

Widget display configuration. Signed preview URLs expire after one hour.

- object
  - `widgetConfig` object, required: Saved widget settings, excluding allowedOrigins and allowEverywhere.
  - `persona` object, required
    - `name` string, required
    - `avatarImageUrl` string, nullable, required: Landscape still image cropped to match the call's video framing.
    - `avatarVideoUrl` string, nullable, required: Verified idle-loop MP4 URL, or null when unavailable. Never a talking preview.

## Other responses

- `404`: Persona was not found or is deleted.
- `500`: Widget configuration could not be loaded.

## Changes

- **2026-09-15** `fc803469630d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anam/apis/anam-ai-api/changes/v1/personas/:id/widget/get.md)

---

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