Save a form draft

Save the editable questions and branching logic. The published form is unaffected.


PATCH/api/v1/forms/{formId}/drafts

Authorization

Authorization required string · header
Send Bearer <token> with an account API key that has the forms:write scope.

Path parameters

formId required string
Form ID. See FormModel.

Request body

application/json

version required integer
Current draft version, returned by Get a form or Save a form draft. A stale version returns 409.
drafts required FormField[]
Complete question and ending array. See FormField, FieldKindEnum, and navigation validation.
logicsLogic[]
Replacement branching rules. Use [] to clear them. When omitted, HeyForm uses existing draft logic or falls back to published logic. See Logic.

Response

200 · application/json

Source model: FormModel.

FieldTypeDescription
idstringID returned by the operation.
draftsarraySanitized editable questions and endings. See FormField.
versionintegerCurrent draft version.