Forms

Delete a submission

DELETE/submissions/{id}
forms:writedelete_submissionDestructiveIdempotent

Soft-deletes the submission and returns 204. Its answers and generated documents stay stored but are no longer reachable through the API, and it can't be undone through the API. It has no dry run, and a repeat returns 404. Emits submission.deleted; sends no email.

Path parameters

  • idstring (uuid)Required#

    The submission's id, a uuid. An unknown id, or a submission you cannot see, returns 404.

Responses

204

The submission was deleted.

401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
422

The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per problem, or a code documented on the operation.

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl -X DELETE https://your-org-domain/kong/core/api/v2/submissions/{id}\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"