Skip to content

The Form API

The Form API is what a form in a visitor’s browser talks to. @seaforms/react calls it for you. It’s here so you know what’s on the wire: for a Content Security Policy, a log, or a look in the network tab.

Endpoint When
POST /f/{formId}/sessions The visitor first touches the form. Opens a session, and says whether the form is open.
POST /f/{formId}/validate A step needs a check only the server can do, such as a blocked email domain.
POST /f/{formId}/partials The visitor moves between steps.
POST /f/{formId}/uploads A file is picked. Then PUT its bytes to /f/{formId}/uploads/{uploadId} and POST …/complete.
POST /f/{formId}/check-coupon A discount code is applied. Codes are checked here, and never appear in the page.
POST /f/{formId}/booking/slots The visitor reaches a booking question. Gets the free times.
POST /f/{formId}/checkout The visitor pays. Our server works out the amount, never the browser.
POST /f/{formId}/resume-link The visitor asks to save and finish later.
POST /f/{formId} Send. Also the <form action> of a post without JavaScript.
  • It never breaks. Its addresses are in published pages, so it only ever gains things. A form published today still works years from now.
  • The server is the source of truth. The browser sends answers, never totals, paths or amounts. The server runs the form’s logic again, and stores its own numbers.
  • It never drops a lead. Anything it can’t confirm came from a person is kept as spam, where Not spam sends it on. The only outright refusals are a form that isn’t open, answers the visitor can fix, and a checkout it can’t confirm.
  • One session stores one submission, so a retry after a lost response never sends twice.
  • Nothing private reaches the page. Discount codes, routing, scores and secrets stay on the server.
Was this helpful?

Your answer goes straight to the person who wrote it.

Thanks. We read every note and update the article.

Thanks, that helps us keep these useful.

ChatGPT is a trademark of OpenAI, and Claude and Claude Code are trademarks of Anthropic. Other product names and logos belong to their owners. None of them makes or endorses Seaforms. Trademarks