Public per-widget runtime config (theme + branded-footer flag)

GET

/v1/embed/{publicWidgetId}/config

Returns the effective theme and branding flag for a widget, gated by the owner’s plan tier. Public/unauthenticated — themes are cosmetic and rendered client-side. 404s for unknown widgets so widget IDs can’t be enumerated.

Parameters

Path Parameters

publicWidgetId

required

string

/^wid_[A-Za-z0-9]+$/

Responses

200

Embed config resolved

object

widgetId

required

string

/^wid_[A-Za-z0-9]+$/

platform

required

string

Allowed values: retell

theme

required

object

primaryColor

string

default: #0EA5A0 /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/

backgroundColor

string

default: #FAFAF7 /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/

foregroundColor

string

default: #0A0A0A /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/

radius

string

default: 12px /^\d+(?:\.\d+)?(?:px|rem|em|%)$/

fontFamily

string

default: 'Geist', system-ui, sans-serif >= 1 characters <= 120 characters /^[A-Za-z0-9 _.,\-'"]+$/

brandedFooter

boolean

default: true

404

Widget not found

object

ok

required

boolean

error

required

object

code

required

string

>= 1 characters

message

required

string

>= 1 characters

requestId

string

>= 1 characters

500

Server error

object

ok

required

boolean

error

required

object

code

required

string

>= 1 characters

message

required

string

>= 1 characters

requestId

string

>= 1 characters