Clipform

Update form settings

Update title, live/draft status, metadata settings, or theme. All fields are optional.

PATCH
/forms/{formId}

Authorization

Authorization
Required
Bearer <token>

API key (cf_*) passed as Bearer token

In: header

Request Body

application/jsonRequired
titlestring
Maximum length: 200
is_liveboolean
show_step_counterboolean

Show step counter (e.g. '1/5')

disable_back_navigationboolean

Prevent respondents from going back

total_stepsinteger

Override total step count (null = auto-calculate)

embed_autoplayboolean

Auto-play video when embedded (default false)

show_brandingboolean

Per-form override for "Powered by Clipform" badge. null = inherit from workspace, true = show, false = hide. Free plans always show branding regardless.

primary_colorstring

Primary/brand color (hex or CSS color)

background_colorstring

Background color (hex, rgba, or CSS color)

font_familystring

Font family name

brand_namestring

Brand name shown alongside the logo in the viewer

logo_urlstring

URL to a logo image shown in the viewer header

descriptionstring

SEO description (meta description, og:description)

authorstring

Author/brand name shown to respondents

Path Parameters

formId
Required
string
Format: "uuid"
curl -X PATCH "https://api.clipform.io/v1/forms/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "is_live": true,
    "show_step_counter": true,
    "disable_back_navigation": true,
    "total_steps": 0,
    "embed_autoplay": true,
    "show_branding": true,
    "primary_color": "string",
    "background_color": "string",
    "font_family": "string",
    "brand_name": "string",
    "logo_url": "string",
    "description": "string",
    "author": "string"
  }'

Form updated

{
  "form_id": "46af4ef5-2c18-4098-9bc5-c048fb90b843"
}