PATCH
/smart-forms/:idUpdate 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/:idHeaders
| Header | Value |
|---|---|
Authorization | Bearer fxk_live_<your-api-key> |
Content-Type | application/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
| Status | Description |
|---|---|
400 | Attempted to update a restricted field on a published form, or validation failure |
401 | Invalid or missing API key |
404 | Smart 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.