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

# Document templates

> List, create, read, update and delete document templates, such as PDF document layouts.

Document templates are the settings records behind generated documents, each with a type such as `PDF_DOCUMENT`. You can list, create, read, update and delete them. This area has 5 endpoints, and all seven SDKs call every one.

## At a glance

| Endpoint | Method | Path | What it does |
| - | - | - | - |
| [List document templates](https://exsited.mintlify.site/api-reference/document-templates/list-document-templates.md) | GET | `/settings/document_templates` | Returns a page of document templates under `data`, with paging details under `pagination`. |
| [Create a document template](https://exsited.mintlify.site/api-reference/document-templates/create-a-document-template.md) | POST | `/settings/document_templates` | Creates a document template and returns it under `document_template`. |
| [Retrieve a document template](https://exsited.mintlify.site/api-reference/document-templates/retrieve-a-document-template.md) | GET | `/settings/document_templates/{document_template_id}` | Returns one document template by its `id`, under `document_template`. |
| [Delete a document template](https://exsited.mintlify.site/api-reference/document-templates/delete-a-document-template.md) | DELETE | `/settings/document_templates/{document_template_id}` | Deletes a document template. The response has no body. |
| [Update a document template](https://exsited.mintlify.site/api-reference/document-templates/update-a-document-template.md) | PATCH | `/settings/document_templates/{document_template_id}` | Changes the fields you send on a document template and returns it under `document_template`. |

## Before you call

Register your API credentials once when your app starts, as shown in
[Authentication](https://exsited.mintlify.site/authentication.md). Every SDK sample on these pages then gets its client in one line.
With cURL, send the access token in an `Authorization` header: `Authorization: Bearer $ACCESS_TOKEN`.

## Things to know

* **`name` and `document_template_type` are required on a create.** For example `"document_template_type": "PDF_DOCUMENT"`.
* **A read reports the type in `type`.** It also says whether the template is a system, custom, default or edited one.
* **A document template `id` starts with `dt_`.**
* **Listings page by cursor.** Records sit under `data`; pass `pagination.next_cursor` as `cursor` to read the next page, and stop when `pagination.has_more` is `false`.
* **A delete returns `204` with no body.** Reading the document template afterwards returns `404`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.