Update a chat widget
Changes a widget; send only what changes. Studio changes wait for the next publish, while the agent, origins, voice and limits apply at once. Send revision to refuse the change (409) if someone else saved first.
Scopes: webchat:write
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Path Parameters
Body
The revision this change is based on; another is 409.
x >= 11 - 8050Response
Successful Response
The widget id.
Its name.
active or deleted.
The key in your site's snippet (public by design).
Websites allowed to load it.
The agent replies by itself.
Visitors can start a voice call.
Per-visitor and voice limits.
The saved studio's revision.
The saved studio differs from what visitors get.
Send as revision on an update.
The agent that answers.
The saved studio document (look and words).
What visitors get now; null until published.
Visitor sessions open now.
ISO 8601.
ISO 8601.