> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voyantcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contract Templates

> Manage reusable contract templates, localized content, and variables for PDF/e-sign generation.

## Endpoints

| Method | Path                         | Description                                                      |
| ------ | ---------------------------- | ---------------------------------------------------------------- |
| GET    | `/v1/contract-templates`     | List contract templates (optionally filtered by locale or type). |
| POST   | `/v1/contract-templates`     | Create a contract template.                                      |
| GET    | `/v1/contract-templates/:id` | Retrieve a contract template (supports locale override).         |
| PUT    | `/v1/contract-templates/:id` | Update template metadata, JSON payload, or translations.         |
| DELETE | `/v1/contract-templates/:id` | Delete a contract template.                                      |

<Info>
  Read operations require the `contract-templates:read` scope. Mutations require `contract-templates:write`.
</Info>

## Key concepts

* Templates store a structured `templateJson` payload with sections and merge variables consumed by PDF and e-sign workflows.
* `type` distinguishes customer, supplier, and partner contract variants; omit it for all-purpose templates.
* Optional `translation` blocks let you attach localized metadata and HTML bodies—fetch with `locale` (or `lang`) query parameters.
* Webhook events (`contract-template.created|updated|deleted`) fire on changes for downstream sync.
* Template variables can be documented inside `translation.variables` to help consumer apps populate dynamic data.