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

# Get widget configuration

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

> **Deprecated.**

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

## Changes

- **2026-08-13** `9fd13f607823` — 3 info
  - api tag `Widget` added
  - api tag `Agents` removed
  - endpoint deprecated
- **2026-06-22** `0eac753eb5dd` — 3 breaking, 19 warning, 2 info
  - removed the media type `application/json` for the response with the status `404`
  - the `data/endButtonText` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `data/startButtonText` response property's minLength was decreased from `1` to `0` for the response status `200`
  - removed the optional property `data/agentBubbleColor` from the response with the `200` status
  - …20 more
- **2026-06-21** `ea4ea58d7c4e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/smallest-inc/apis/agent-management-api/changes/agent/:id/widget-config/get.md)

---

[API](https://skmtc.dev/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.dev/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/fed4f750ea02/schema)