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

# Preview Avatar

> Generate a short-lived preview link to see an avatar in a live session

<Note>
  **What This Does:** Creates a temporary agent and a one-time preview link that expires in **5 minutes**. Opening the returned URL launches a live video session using the specified avatar, so you can see exactly how it will look and behave before using it in production.
</Note>

### Body

<ParamField body="avatar_id" type="string" required>
  The avatar ID to preview (format: `avat_<ULID>` or a pre-built avatar ID such as `PUBLIC/Avatars/sara-office`). Returned by [Upload Face Avatar](/api-reference/endpoints/upload-face-avatar) or found via [List Avatars](/api-reference/endpoints/list-avatars).
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Whether the preview link was created successfully.
</ResponseField>

<ResponseField name="url" type="string">
  A one-time preview URL (expires in 5 minutes, single-use). Open this in a browser to start a live video session with the avatar.
</ResponseField>

<ResponseExample>
  ```json 201 - Success theme={null}
  {
    "success": true,
    "url": "https://links.agenthuman.com/lnk_01J8ZK4R2N5M6P7Q8W4T"
  }
  ```

  ```json 400 - Missing Avatar ID theme={null}
  {
    "success": false,
    "error": {
      "message": "avatar_id is required"
    }
  }
  ```

  ```json 401 - Unauthorized theme={null}
  {
    "success": false,
    "error": {
      "message": "Unauthorized"
    }
  }
  ```
</ResponseExample>