API referenceTemplates
Delete template
Permanently delete a template and all of its versions.
Delete template
Permanently deletes a template. This removes every version of the template; mappings that depend on it are orphaned and must be deleted or re-pointed at another template.
Signature
DELETE /api/v1/templates/{template_id}Permissions
API key scope: admin. Caller must own the template.
Path parameters
| Name | Type | Description |
|---|---|---|
template_id | integer | Template ID. |
Example
curl -X DELETE https://api.simplyfill.app/v1/templates/123 \
-H "Authorization: Bearer $SIMPLYFILL_API_KEY"await client.templates.delete(123)client.templates.delete(123)Response
204 No Content. The response body is empty.
Errors
| Status | error code | Cause |
|---|---|---|
403 | not_template_owner | Authenticated user does not own the template. |
404 | template_not_found | No template with the given ID. |
Deletion is permanent
Past generations referencing this template remain valid (their PDFs are already produced), but you cannot generate new PDFs from this template after deletion. To preserve history without deletion, use the dashboard's archive flag instead.