Update a form

Updates a form's schema, settings, or status. Existing submissions are preserved even if the schema changes.

Required permissions

forms.update

PUT/forms/{id}

Base URLhttps://api.lynkow.com/v1

Path parameters

idstringrequired: Unique identifier

Request bodyrequired

namestring
Display name. 1-255 characters
slugstring
URL-friendly identifier, unique per site and locale. 1-255 characters
schemaobject
Field schema definition
- pagesarray<object>
  - titlestring
  - fieldsarray<string>required
  - descriptionstring
- fieldsarray<object>required
  - idstringrequired
  - typeenumrequired
    One of: textemailteltextareaselectcheckboxradiodatedatetimetimenumberfileratinghidden
  - labelstringrequired
  - widthenum
    One of: fullhalfthird
  - optionsarray<object>
    - labelstringrequired
    - valuestringrequired
  - requiredboolean
  - conditionsarray<object>
    - fieldstringrequired
    - valueany
    - actionenumrequired
      One of: showhiderequireskip_to_page
    - operatorenumrequired
      One of: equalsnot_equalscontainsnot_containsgreater_thanless_thanis_emptyis_not_empty
    - targetPagenumber
  - validationobject
    - maxnumber
    - minnumber
    - acceptstring
    - maxSizenumber
    - patternstring
    - maxLengthnumber
    - minLengthnumber
  - descriptionstring
  - placeholderstring
  - defaultValueany
- settingsobject
  - redirectUrlstring
  - requireAuthboolean
  - submitLabelstring
  - closedMessagestring
  - successMessagestring
  - showProgressBarboolean
- conditionsarray<object>
  - fieldstringrequired
  - valueany
  - actionenumrequired
    One of: showhiderequireskip_to_page
  - operatorenumrequired
    One of: equalsnot_equalscontainsnot_containsgreater_thanless_thanis_emptyis_not_empty
  - targetPagenumber
statusenum
One of: draft, active, closed, archived
One of: draftactiveclosedarchived
settingsobject
Configuration settings
descriptionstring
Description text. Max 1000 characters
notificationsobject
Notification preferences
- emailobject
  - toarray<string>required
  - enabledbooleanrequired
  - replyTostring
  - subjectstring
  - templatestring
- webhookobject
  - urlstringrequired
  - methodenum
    One of: POSTPUT
  - enabledbooleanrequired
  - headersobject
  - retryCountnumber
honeypotEnabledboolean
Boolean
recaptchaEnabledboolean
Boolean
recaptchaSiteKeystring
Max 255 characters
recaptchaSecretKeystring
Max 255 characters

View as markdown Install Lynkow Skills

curl --request PUT \
  --url 'https://api.lynkow.com/v1/forms/<id>' \
  --header 'Authorization: Bearer $API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "data": {
    "id": 1,
    "name": "Contact Form v2",
    "slug": "contact-form",
    "locale": "en",
    "schema": [
      {
        "name": "name",
        "type": "text",
        "label": "Full Name",
        "required": true
      },
      {
        "name": "email",
        "type": "email",
        "label": "Email",
        "required": true
      },
      {
        "name": "message",
        "type": "textarea",
        "label": "Message",
        "required": true
      }
    ],
    "status": "active",
    "createdAt": "2025-01-05T10:00:00.000Z",
    "updatedAt": "2025-04-06T12:00:00.000Z",
    "redirectUrl": null,
    "successMessage": "We will get back to you within 24h.",
    "submissionCount": 134
  }
}

Feedback

Path parameters

Request bodyrequired

Was this page helpful?