Delete a submission

DELETE

/v1/forms/{form}/submissions/{id}

curl --request DELETE \
  --url https://api.submeto.com/v1/forms/example/submissions/example \
  --header 'Authorization: Bearer <token>'

Makes a submission and its files unavailable immediately, then permanently purges them under retention policy. Requires the submissions:delete scope.

Authorizations

• default

Parameters

Path Parameters

form

required

string

The form ID.

id

required

string

The ID of the submission.

submission

required

string

The submission ID.

Responses

202

Journaled deletion accepted

Media typeapplication/json

object

data

object

status

string

request_id

string

Example

{
  "data": {
    "status": "accepted"
  },
  "request_id": "01JREQ..."
}

204

Submission deleted before retention apply cutover

Media typeapplication/json

object

Example^generated

{}

404

Not found or not granted

Media typeapplication/json

object

error

object

code

string

message

string

details

object

request_id

string

Example

{
  "error": {
    "code": "resource_not_found",
    "message": "Resource not found.",
    "details": {}
  },
  "request_id": "REQUEST_ID"
}