forms

Publish a new schema version

Schemas are immutable versions — this always creates version N+1, never mutates an existing one.

post/v1/forms/{formId}/schema

Request

  • Base URL: https://postbag.dev
  • URL: https://postbag.dev/v1/forms/{formId}/schema
  • Auth: HTTP bearer

Path parameters

formIdstring required
Example:fm_8f3kq2

Request body

json_schemaobject required

JSON Schema draft 2020-12 describing the submission data. required drives drift detection and mapping completeness.

uiobject

Per-field rendering hints keyed by field name (label, placeholder, widget, options, order) — used to render embed snippets.

changelogstring

A short human note on what changed in this version, shown in the version history.

Response

published

json_schemaobject required
uiobject
changelogstring
versioninteger
inferredboolean
created_atstring
created_bystring

Example response

{
  "created_at": "2026-08-21T09:00:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.