PATCH/smart-forms/:id

Update Smart Form

Update the configuration of an existing smart form

Scope: SMART_FORMS_WRITE

Overview

Updates one or more fields on an existing smart form. All body fields are optional — only the provided fields are updated. Published forms can only have their title updated; all other fields require the form to be in DRAFT status.

Request

PATCH/smart-forms/:id

Headers

HeaderValue
AuthorizationBearer fxk_live_<your-api-key>
Content-Typeapplication/json

Path Parameters

Request Body

All fields are optional. Omit fields you do not want to change.

Published Form Restrictions

Once a smart form is published, only the title field can be updated. Attempting to update any other field on a published form returns a 400 error. To change other fields, unpublish the form first.

Example Request

curl -X PATCH "https://api.formfex.com/api/v1/public/smart-forms/SMART_FORM_ID" \
  -H "Authorization: Bearer $FORMFEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Survey Title",
    "maxQuestions": 10
  }'

Response

Error Cases

StatusDescription
400Attempted to update a restricted field on a published form, or validation failure
401Invalid or missing API key
404Smart form not found or not owned by this API key

n8n

In n8n, this operation is available as Update under the Smart Form resource in the Formfex node.