Migration guides

Moving between endpoints and versions.

Move from /f/{public_id} to /v1/forms/{public_id}/submissions

The short endpoint remains supported, but new integrations should use the versioned endpoint.

  1. Replace the form action or fetch URL.
  2. Keep the same request body, headers and idempotency key.
  3. Confirm the response shape is unchanged.
  4. Test both success and error handling.
  5. Update the integration snippet in the administration portal.

No payload migration is required.

Future versions

When a breaking change requires a new version:

  • the old version remains available for a documented migration window;
  • the new version receives its own OpenAPI path and examples;
  • this page gains a step-by-step migration guide;
  • the changelog records the change.

No breaking version migration exists at the time of writing.