Publish a form
Publish the submitted questions and branching logic and enable responses.
POST
/api/v1/forms/{formId}/publishAuthorization
Authorization required string · header
Bearer <token> with an account API key that has the forms:write scope. Path parameters
formId required string
Request body
application/json
version required integer
409. drafts required FormField[]
logicsLogic[]
[] to clear them. When omitted, HeyForm uses existing draft logic or falls back to published logic. See Logic. The request keeps the supplied version. When publishing a draft you just saved, use the version and sanitized drafts returned by the save request.
Response
201 · application/json
Source model: FormModel.
| Field | Type | Description |
|---|---|---|
id | string | ID returned by the operation. |
active | boolean | Whether the form accepts responses. |
version | integer | Current draft version. |
publishedAt | integer | Time of first publication as Unix seconds. 0 means the form has never been published. |