---
title: "Get widget configuration"
method: GET
path: "/agent/{id}/widget-config"
tags: ["Agents"]
---

# Get widget configuration

`GET /agent/{id}/widget-config`

Returns the current web widget configuration for the agent. Also includes `assistantId` (same as the agent ID) as a convenience field for the widget embed code.

## Path parameters

- `id` string, required

## Response `200`

Widget configuration

- object
  - `success` boolean
  - `data` object — All fields may be absent if not yet configured
    - `assistantId` string — Same as the agent ID — convenience field for the widget embed code
    - `position` 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'
    - `size` 'tiny' | 'compact' | 'full'
    - `borderRadius` number
    - `mode` 'chat' | 'voice'
    - `theme` 'light' | 'dark'
    - `baseColor` string
    - `accentColor` string
    - `title` string
    - `startButtonText` string
    - `endButtonText` string
    - `avatarUrl` string, nullable
    - `voiceShowTranscript` boolean
    - `consentRequired` boolean

## Other responses

- `401` — Unauthorized access
- `404` — Agent not found
- `500` — Internal server error

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/versions/6d1036a76fbc/schema)