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

# Widgets

> Manage New Frontend widget configurations through the public API.

The Widgets API manages the isolated New Frontend widget resource. Widget
configuration is organization-scoped by the API key; do not send an
organization ID in requests.

Use `POST /widgets` to create a saved configuration. The response includes the
widget ID; use `GET /widgets/{widget_id}/public-config` for the safe
configuration needed by an embed client.

Every write accepts the optional `X-Idempotency-Key` header. To start a call,
use the canonical [Web Call API](/api-reference/calls#create-web-call) from a
trusted server; widget configuration endpoints do not start provider calls.