Delete contract template
Permanently deletes a template version and its stored source file.
Returns 404 if the template does not exist. Returns 400 if it (or a
signing workflow built on it) is linked to a sent contract request —
cascade-deletes only its own signing workflows (Contract Flows), never
actual contract requests.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Permanently delete a contract template version, regardless of its status (including archived). This also removes the template's stored source file from storage, and cascade-deletes any contract flows built on this template. Those flows are removed as part of this call. The deletion is irreversible. On success the endpoint returns no content.
Authentication & access
- Requires a client API token:
Authorization: Bearer <token>. - API credentials need the
contracts.templates.archivepermission. Dashboard users need the OWNER or OPERATIONS role, or a custom role that includes this permission. - Contract signing must be enabled for the client. If it is disabled the request returns
403.
Path parameters
| Name | In | Description |
|---|---|---|
template_version_id | path | The id of the template version to delete. Must belong to your client. |
Preconditions
- The template version must not be used by any contract request, whatever that request's status, including requests sent through a contract flow built on the template. The template's status does not matter, and contract flows built on the template that have no contract requests do not block it.
- Any contract flow still built on this template is cascade-deleted along with it. If you need to keep those contract flows, point them at a different template version first.
A template used by a contract request is rejected with 400. To stop using such a template, archive it instead with Archive Contract Template.
Response
204 No Content- the template version and its stored source file were permanently deleted. The response body is empty.
Error responses
| Status | When |
|---|---|
400 | Template is used by a contract request |
403 | Contract signing is disabled for the client |
404 | No template version with this id exists under your client |
Standard 401 (authentication), 403 (insufficient permission or role), and 429 (rate limit) responses apply to every endpoint and are documented in the Error reference.
204Successful Response