delete
https://api-sandbox.urbanpayx.com/api/v1/contracts/templates/
Delete archived contract template
Permanently deletes an archived template version and its stored source file.
Templates linked to workflows or contract requests cannot be deleted.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Permanently delete an archived contract template version. This also removes the template's stored source file from storage. The deletion is irreversible, so the template must first be archived and must not be referenced by any workflow or contract request. On success the endpoint returns no content.
Authentication & access
- Requires a client API token:
Authorization: Bearer <token>. - The caller must hold the
contracts.templates.archivepermission and have the OWNER or OPERATIONS role. - The client must have contract signing enabled. If the feature 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 be in archived status. Draft or published templates cannot be deleted; archive the template first.
- The template version must have no dependents. A template still linked to a workflow or a contract request cannot be deleted.
A template that violates either precondition is rejected with 400.
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 not archived, or it is still linked to a workflow or 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.
Successful Response