update_hosted_form — FormMaker docs

You shipped a hosted form and now want a different button label, a different accent colour, or to switch it into (or out of) conversational mode. This changes that, live on the next page load — the formId, embed snippet, and share link never change.

Pass only the settings you want to change; everything else is left exactly as it was. An empty string resets a theme value back to the widget's default.

This is presentation only. It never touches the form's fields and never changes where submissions go — if you need either of those, create a new form with create_hosted_form.

Change a hosted form's presentation after creating it

Change the presentation of an existing hosted form — its title, button text, theme colours, or whether it asks one question per screen. The change is live on the next page load; the formId, embed snippet and share link never change. This changes presentation ONLY: it never edits the form's fields and never changes where submissions go — for that, create a new form. Pass only the settings you want to change; the rest are left alone. An empty string resets a theme value to its default.

read-onlyidempotentopen-world

Parameters

Name	Type		Description
`formId`	`string`	required	—
`name`	`string`	optional	The form's title — the page title, and the heading above the fields in a standard (non-conversational) form.
`buttonText`	`string`	optional	The submit button's label. Name what the visitor gets, never "Submit".
`brandColor`	`string`	optional	Primary brand colour, e.g. "#0f766e". "" resets to default.
`inkColor`	`string`	optional	Body text colour. "" resets to default.
`bgColor`	`string`	optional	Background of the hosted /f/ page (not the embed). "" resets to default.
`radius`	`string`	optional	Corner radius, e.g. "8px". "" resets to default.
`fontFamily`	`string`	optional	Font family. "" resets to default.
`mode`	`"conversational" \| ""`	optional	"conversational" asks one question per screen; "" clears it back to a standard form. Omit to leave unchanged.
`style`	`object`	optional	Custom style knobs, as { knob: value }. Allowed knobs: surface, border (colours, e.g. "#0b1211"); fieldGap, labelSize (lengths, e.g. "24px"); buttonInk (colour); shadow ("none"\|"soft"\|"strong"). "" resets a knob to default. Invalid names/values are rejected. Presentation only — never touches fields or where submissions go.