Posty5 Form Submission

Manage form submissions from HTML pages. v1 is legacy: update and delete overwrite (last write wins)

Actions4

Change Status

AI-generated

Summary

Change the status of a specific Posty5 form submission by its ID, optionally including a rejected reason and additional notes. Supports optimistic concurrency control via a version parameter to prevent overwriting changes made since retrieval.

Inputs

  • Submission ID (required) — The ID of the form submission to update.
  • Status (required) — The new status to set for the form submission. Allowed values include 'new', 'pendingReview', 'inProgress', 'onHold', 'needMoreInfo', 'approved', 'partiallyApproved', 'rejected', 'completed', 'archived', and 'cancelled'.
  • Rejected Reason — Optional reason for rejection if the status is set to 'rejected'.
  • Notes — Optional additional notes about the status change.
  • Version (required) — The version (__v) of the form submission as last retrieved, used for optimistic concurrency to ensure the submission has not changed. Use output from a prior Get operation. If the version is not known or empty, behavior depends on Version Options.
  • Version Options — Options controlling behavior when the Version field is empty, including failing with an error or using the latest version (last write wins).

Output shape

a single updated form submission record with applied status changes

If the submission has been modified since the provided Version, the operation fails with a conflict error unless Version Options allow overwriting the latest version. The output includes the updated submission data with its current version.

Examples

Example 1: Change the status of a form submission to 'Approved' with notes

Set Submission ID to the target ID, Status to 'approved', optionally provide Notes, and map Version from the Get operation's output.

Links

Discussion