EaserixDocs
DevelopersAPI referenceFormsSubmissions

Delete submissions in bulk

Hard-deletes submissions and takes them off the form's counters. Exactly one selector, from the JSON body or the query string: ids (at most 1000; in the query, repeated or comma-separated) deletes those submissions whether or not they are spam, and ids of other forms are ignored; before (RFC 3339) deletes everything received before that instant, leaving spam alone unless includeSpam is true. Owner-only — a shared form returns 403. Recorded in the audit log (submissions.deleted) when anything was deleted.

View as Markdown
DELETE
/v1/forms/{id}/submissions

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Query Parameters

ids?array<string>
before?string
Formatdate-time
includeSpam?string

With before, spam is included only when "true"

Value in

  • "true"
  • "false"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/forms/string/submissions" \  -H "Content-Type: application/json" \  -d '{}'
{  "deleted": 0}

List submissions

Non-spam submissions by default; pass includeSpam=true for everything. created_at descending, limit 500. Submissions are children of the form, so a teammate who can read a shared form can read its inbox.

Mark spam / not spam

Flips the spam flag and adjusts the form's spamCount. Returns a message, not the submission. Owner-only — triaging a shared form's inbox returns 403.