Form templates
Delete a form template
Hard-deletes the template — allowed only when it has zero submissions. With submissions present the API returns `409`; archive it instead so audit records are never orphaned.
Hard-deletes the template — allowed only when it has zero submissions.
With submissions present the API returns 409; archive it instead so
audit records are never orphaned.
x-api-key<token>
The per-tenant API key, copied from Settings → API & integrations.
Sent as the x-api-key request header. The key is tenant-scoped and acts
with Admin-equivalent, tenant-wide access.
In: header
Path Parameters
id*string
Resource id.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/form-templates/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "deleted": true}{ "error": { "code": "unauthorized", "message": "Missing or invalid API key." }}{ "error": { "code": "read_only", "message": "Your subscription is inactive. This action is read-only." }}{ "error": { "code": "not_found", "message": "Not found." }}{ "error": { "code": "conflict", "message": "This template has submissions and can't be deleted. Archive it instead." }}