---
title: "Get Widget Config"
method: GET
path: "/v1/agent/agents/{agent_id}/widget"
tags: ["Agents"]
---

# Get Widget Config

`GET /v1/agent/agents/{agent_id}/widget`

## Request

- Base URL: `https://api.fish.audio`
- URL: `https://api.fish.audio/v1/agent/agents/{agent_id}/widget`
- Auth: none declared

Unauthenticated display configuration for the embeddable `<fish-agent>`
widget. Only agents published as public are reachable, and the request
`Origin` must match the agent's allowed origins — the same gate as
anonymous session creation. Attributes set on the embed tag override
every field returned here.

## Path parameters

- `agent_id` string, required

## Headers

- `origin` string, nullable

## Response `200`

Request fulfilled, document follows

- object: Display config for the embeddable `<fish-agent>` widget. Served without authentication for public agents; HTML attributes on the embed tag override every field. Grows alongside the Builder widget tab (greeting, policy switches, styles) — additions only, never renames.
  - `agent_name` string, required

## Other responses

- `403`: Request forbidden -- authorization will not help
- `404`: Nothing matches the given URI

## Changes

- **2026-11-03** `42ac421f7a12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fish/apis/fishaudio-openapi/changes/v1/agent/agents/:agent_id/widget/get.md)

---

[API](https://skmtc.dev/fish/apis/fishaudio-openapi.md) - [All operations](https://skmtc.dev/fish/apis/fishaudio-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/fish/apis/fishaudio-openapi/revisions/42ac421f7a12?raw)