---
title: "Update Template Files"
method: POST
path: "/template/update_files/{template_id}"
tags: ["Template"]
---

# Update Template Files

`POST /template/update_files/{template_id}`

Overlays a new file with the overlay of an existing template. The new file(s) must:

1. have the same or higher page count
2. the same orientation as the file(s) being replaced.

This will not overwrite or in any way affect the existing template. Both the existing template and new template will be available for use after executing this endpoint. Also note that this will decrement your template quota.

Overlaying new files is asynchronous and a successful call to this endpoint will return 200 OK response if the request passes initial validation checks.

It is recommended that a callback be implemented to listen for the callback event. A `template_created` event will be sent when the files are updated or a `template_error` event will be sent if there was a problem while updating the files. If a callback handler has been configured and the event has not been received within 60 minutes of making the call, check the status of the request in the API dashboard and retry the request if necessary.

If the page orientation or page count is different from the original template document, we will notify you with a `template_error` [callback event](https://app.hellosign.com/api/eventsAndCallbacksWalkthrough).

## Path parameters

- `template_id` string, required

## Request body

- TemplateUpdateFilesRequest
  - `client_id` string — Client id of the app you're using to update this template.
  - `files` string[] — Use `files[]` to indicate the uploaded file(s) to use for the template. This endpoint requires either **files** or **file_urls[]**, but not both.
  - `file_urls` string[] — Use `file_urls[]` to have Dropbox Sign download the file(s) to use for the template. This endpoint requires either **files** or **file_urls[]**, but not both.
  - `message` string — The new default template email message.
  - `subject` string — The new default template email subject.
  - `test_mode` boolean — Whether this is a test, the signature request created from this draft will not be legally binding if set to `true`. Defaults to `false`.

## Response `200`

successful operation

- TemplateUpdateFilesResponse
  - `template` TemplateUpdateFilesResponseTemplate, required — Contains template id
    - `template_id` string — The id of the Template.
    - `warnings` WarningResponse[] — A list of warnings.
      - `warning_msg` string, required — Warning message
      - `warning_name` string, required — Warning name

## Other responses

- `4XX` — failed_operation

---

[API](https://skmtc.net/hellosign/apis/dropbox-sign-api.md) · [All operations](https://skmtc.net/hellosign/apis/dropbox-sign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellosign/dropbox-sign-api/versions/2ea3f04008af/schema)