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

# get persona widget

> 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.



## OpenAPI

````yaml https://api.anam.ai/swagger.json get /v1/personas/{id}/widget
openapi: 3.1.0
info:
  title: Anam AI API
  version: '1.0'
servers:
  - url: https://api.anam.ai
    description: Anam API
security:
  - BearerAuth: []
tags:
  - name: Sessions
  - name: Avatar Videos
  - name: Meetings
  - name: Watermark Checks
  - name: Personas
  - name: Avatars
  - name: Voices
  - name: Pronunciation Dictionaries
  - name: LLMs
  - name: Knowledge
  - name: Tools
  - name: Share Links
  - name: Engine
paths:
  /v1/personas/{id}/widget:
    get:
      tags:
        - Personas
      summary: Get persona widget display configuration
      description: >-
        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.
      operationId: getPersonaWidget
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
          description: Persona ID.
        - in: header
          name: Origin
          schema:
            type: string
          description: Request origin, echoed in the CORS response.
      responses:
        '200':
          description: >-
            Widget display configuration. Signed preview URLs expire after one
            hour.
          headers:
            Cache-Control:
              schema:
                type: string
              description: public, max-age=60, stale-while-revalidate=300
            Access-Control-Allow-Origin:
              schema:
                type: string
              description: Request origin, or * when absent.
            Vary:
              schema:
                type: string
                example: Origin
          content:
            application/json:
              schema:
                type: object
                required:
                  - widgetConfig
                  - persona
                properties:
                  widgetConfig:
                    type: object
                    additionalProperties: true
                    description: >-
                      Saved widget settings, excluding allowedOrigins and
                      allowEverywhere.
                  persona:
                    type: object
                    required:
                      - name
                      - avatarImageUrl
                      - avatarVideoUrl
                    properties:
                      name:
                        type: string
                      avatarImageUrl:
                        type:
                          - string
                          - 'null'
                        description: >-
                          Landscape still image cropped to match the call's
                          video framing.
                      avatarVideoUrl:
                        type:
                          - string
                          - 'null'
                        description: >-
                          Verified idle-loop MP4 URL, or null when unavailable.
                          Never a talking preview.
              example:
                widgetConfig: {}
                persona:
                  name: Assistant
                  avatarImageUrl: >-
                    https://lab.anam.ai/api/avatars/0f3b4c5e-1a2b-4c3d-9e8f-7a6b5c4d3e2f/image/landscape?v=3f2a1b0c9d8e7f6a
                  avatarVideoUrl: null
        '404':
          description: Persona was not found or is deleted.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Persona not found
        '500':
          description: Widget configuration could not be loaded.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Failed to fetch widget config
      security: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.