Manual

Forms

Create, configure, publish, and manage forms.

A form is the main unit of work in Formlism. It has a title, optional description, question array, settings object, tags, publish state, and optional folder assignment.

Create a form

Create forms in the app for visual editing, or through the developer API when an external system needs to provision forms programmatically. API-created forms use the same raw Formlism-style question and settings payloads as the app.

Publish state

Forms can be saved before they are public. Use the publish action in the app, or call POST /api/developer/forms/:formId/publish. To take a form out of circulation, call POST /api/developer/forms/:formId/unpublish.

Operational notes

  • Form IDs are UUIDs.
  • Titles are required and capped at 255 characters.
  • Descriptions can be null and are capped at 5000 characters.
  • Tags are strings capped at 100 characters each, with up to 50 tags on writes.