Delete Contract Template

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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.archive permission. 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

NameInDescription
template_version_idpathThe 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

StatusWhen
400Template is used by a contract request
403Contract signing is disabled for the client
404No 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.

Path Params
string
required
Responses
204

Successful Response

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json