Update Form

Updates a form’s name or settings. Only the fields you include in the request body are changed.


PATCH /v1/forms/{formId}

Request


curl -X PATCH https://api.formtorch.com/v1/forms/a1b2c3d4e5 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Contact Us"}'

Path parameters

Parameter	Description
`formId`	The 10-character form ID

Request body

All fields are optional. Only provided fields are updated.

Field	Type	Description
`name`	string	New display name for the form

Response

Returns the updated form object.


{
  "id": "a1b2c3d4e5",
  "name": "Contact Us",
  "projectId": "p9q8r7s6t5",
  "endpoint": "https://formtorch.com/f/a1b2c3d4e5",
  "submissionCount": 142,
  "createdAt": "2025-01-10T09:00:00.000Z",
  "updatedAt": "2025-03-15T10:00:00.000Z"
}

Error responses

Status	Code	Description
`404`	`form_not_found`	No form with this ID in your account
`422`	`validation_error`	Name is empty or too long