PATCH/forms/:id/fields/:fieldId

Update Field

Update an existing field in a form

Scope: FORMS_WRITE

Overview

Updates properties of an existing field in a form's schema. Only the fields you include in the request body will be changed — omitted properties remain unchanged.

Request

PATCH/forms/:id/fields/:fieldId

Path Parameters

Headers

Header	Value
`Authorization`	`Bearer fxk_live_<your-api-key>`
`Content-Type`	`application/json`

Request Body

All fields are optional. Only include the properties you want to update.

Example Request

curl -X PATCH "https://api.formfex.com/api/v1/public/forms/FORM_ID/fields/FIELD_ID" \
  -H "Authorization: Bearer $FORMFEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Full Name",
    "required": true,
    "placeholder": "Enter your full name"
  }'

Response

Error Cases

Status	Condition
`400`	Invalid `fieldId` format (must be alphanumeric with `-_`, max 128 chars)
`400`	New `sectionId` does not exist in the form schema
`404`	Form not found or soft-deleted
`404`	Field not found in the form schema

PreviousAdd Field NextDelete Field