submissions

Change status (re-routes if moving to received)

Moving a quarantined submission to received re-runs routing and queues deliveries for it. An over_quota submission stays quarantined until the current plan has capacity.

patch/v1/submissions/{submissionId}

Request

  • Base URL: https://postbag.dev
  • URL: https://postbag.dev/v1/submissions/{submissionId}
  • Auth: HTTP bearer

Path parameters

submissionIdstring required

Request body

status'received' | 'quarantined' | 'spam' required

Response

ok

idstring required
form_idstring required
status'received' | 'quarantined' | 'spam' required
quarantine_reasonstring nullable required

Machine-readable reason when status is quarantined: schema_violation, rate_limited, origin_rejected, turnstile_failed, or over_quota. Null for received or spam submissions.

testboolean required
dataobject required
form_schema_versioninteger nullable required
metaobject required
received_atstring required

Example response

{
  "id": "fm_8f3kq2",
  "form_id": "fm_8f3kq2",
  "received_at": "2026-08-21T09:00:00.000Z"
}

Changes

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