Delete a form

DELETE

/v1/forms/{id}

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

Deletes a form and all its fields and submissions. Requires the forms:delete scope and an If-Match header carrying the Form validator from the last GET.

Authorizations

• default

Parameters

Path Parameters

id

required

string

The form ID.

Header Parameters

If-Match

string

Responses

204

Form deleted

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"
}

412

Stale ETag

Media typeapplication/json

object

error

object

code

string

message

string

details

object

request_id

string

Example

{
  "error": {
    "code": "precondition_failed",
    "message": "The Form revision does not match the If-Match ETag.",
    "details": {}
  },
  "request_id": "REQUEST_ID"
}

428

Missing If-Match

Media typeapplication/json

object

error

object

code

string

message

string

details

object

request_id

string

Example

{
  "error": {
    "code": "precondition_required",
    "message": "A current If-Match Form validator is required.",
    "details": {}
  },
  "request_id": "REQUEST_ID"
}