DELETE/submissions/{submissionId}

Delete a submission

Deletes a stored form submission identified by its unique submission ID. Use submissionId to target the record; quarantined spam submissions cannot be deleted. A successful deletion returns no response body.

1 parameter
submissionIdstringrequired
The identifier of the submission to delete. Must contain at least one character.

8 status codes
204Returns no content after the submission is deleted.
400Returned when the request is malformed or fails validation.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
401Returned when the token is missing, malformed, revoked, or expired.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
403Returned when the token lacks the required scope, the workspace is not upgraded, or a limit has been reached.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
404Returned when the requested resource does not exist.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
409Returned when the submission is quarantined spam and cannot be deleted.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
429Returned when the caller is rate limited and should retry later.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired
500Returned when something goes wrong on the service's end.
codestringrequired
detailstringrequired
statusnumberrequired
titlestringrequired
typestringrequired

Error handling

A 400 is returned for malformed requests or validation failures; a 401 is returned when the token is missing, malformed, revoked, or expired; a 403 is returned when the token lacks the required scope, the workspace is not upgraded, or a limit is reached; and a 404 is returned when the resource does not exist. A 409 is returned when the submission is quarantined spam and cannot be deleted; a 429 means the caller is rate limited; and a 500 indicates an error on the service's end. The submissionId path parameter must contain at least one character.