# Actualizar plantilla

Al utilizar este endpoint con el token de la plantilla, puedes actualizar los datos como el nombre y el idioma de la plantilla. También es posible alternar su estado entre activado y desactivado. Restablecer los correos electrónicos de los contactos que serán notificados sobre la plantilla. Y por último, editar los campos de configuración del primer firmante definido en la plantilla.

## Actualizar plantilla

<mark style="color:green;">`PUT`</mark>`https://api.zapsign.com.br/api/v1/templates/{{template_token}}/`

{% hint style="success" %}
En el endpoint anterior, sustituye `{{template_token}}` por el token exclusivo de la plantilla que deseas actualizar.
{% endhint %}

### **Encabezado**

<table><thead><tr><th width="175">Nombre</th><th width="103">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td>string</td><td>API token prefijo con la palabra "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23</td></tr></tbody></table>

### Request Body

<table><thead><tr><th width="124">Name</th><th width="158">Type</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>string</td><td>Título de la plantilla máximo 255 caracteres.</td></tr><tr><td>lang </td><td>string</td><td><p>Idioma del documento Posibles valores: "pt-br" (Portugues), "es" (Español), "en" (Inglés), "fr" (Francés).</p><p>Valor por defecto: "pt-br"</p></td></tr><tr><td>observers </td><td>array&#x3C;string></td><td>Representa a los observadores del documento (hasta 20 personas), es decir, direcciones de correo electrónico que serán notificadas cuando se firme un documento generado a partir de esta plantilla. Es un array de correos electrónicos.</td></tr><tr><td>first_signer</td><td>Object</td><td>Configuración del firmante del documento.</td></tr><tr><td>folder_token</td><td>string</td><td>Si se proporciona, este campo tendrá prioridad sobre folder_path. Define el directorio basado en el token de la carpeta, que se puede obtener accediendo a:
<br>https://zapsign.com.br/conta/modelos?pasta=&#x3C;folder_token>
<br>Si aún no conoces el token, navega hasta la carpeta deseada a partir de:
<br>https://zapsign.com.br/conta/modelos
<br>y copia el valor del parámetro pasta en la URL después de abrir la carpeta.</td></tr><tr><td>folder_path</td><td>string</td><td>Especifica la ruta de la carpeta dentro de ZapSign donde se guardará el modelo. Si las carpetas no existen, se crearán automáticamente.
<br>Requisitos:
<br>folder_path puede tener hasta 255 caracteres
<br>Cada carpeta puede tener hasta 50 caracteres
<br>Hay un límite de 5 niveles de carpetas
<br>Ejemplo: /api/ o /carpeta1/carpeta2/carpeta3/
<br>Valor predeterminado: / (sin carpeta)</td></tr><tr><td>redirect_link</td><td>string</td><td>Permite configurar un botón que se muestra al final de la firma para redirigir al firmante a una URL específica, como una página de agradecimiento o cualquier otra página de su sitio web.<br>Ejemplo: <a href="https://zapsign.com.br/">https://zapsign.com.br/</a></td></tr></tbody></table>

{% hint style="danger" %}
El parámetro **url\_docx** o **base64\_docx** no puede ser modificado. Si necesitas cambiar el documento de la plantilla, será necesario crear una plantilla nueva.
{% endhint %}

### **Configurando** el Firmante

Estos campos permiten ajustar la experiencia de firma, como el método de autenticación.

{% hint style="warning" %}
Para entender más sobre los campos de configuración del firmante, accede a la página de[ creación de plantilla](/espanol/plantillas/create-template-docx.md).
{% endhint %}

### Request

```javascript
{
    "name": "Nombre de la plantilla",
    "lang": "es",
    "observers": [
        "email@email.com"
    ],
    "first_signer": {
        "blank_email": false,
        "blank_phone": false,
        "auth_mode": "assinaturaTela",
        "require_selfie_photo": false,
        "require_document_photo": false,
        "selfie_validation_type": "",
        "qualification": "Aprobador"
    }
}
```

### Response

{% tabs %}
{% tab title="200: OK  -  Plantilla actualizada con éxito" %}

```javascript
{
	"token": "152f8416-xxxx-xxxx-xxxx-1aaf785dd335",
	"template_type": "docx",
	"name": "Nombre de la plantilla",
	"active": true,
	"template_file": "https://zapsign.s3.amazonaws.com/2022/1/docs/xxxxx-d66b-495f-9b51-xxxx.docx",
	"created_at": "2022-01-05T12:59:42.563218Z",
	"last_update_at": "2022-01-05T13:03:22.242003Z",
	"redirect_link": "",
	"folder_path": "",
	"lang": "es"
	"signers": [
		{
			"name": "{{NOMBRE COMPLETO}}",
			"auth_mode": "assinaturaTela",
			"email": "",
			"phone_country": "",
			"phone_number": "",
			"lock_name": true,
			"lock_phone": false,
			"lock_email": false,
			"hide_phone": false,
			"blank_phone": false,
			"hide_email": false,
			"blank_email": false,
			"require_selfie_photo": false,
			"require_document_photo": false,
			"selfie_validation_type": "none",
			"qualification": "Aprobador"
		}
	],
	"inputs": [
		{
			"variable": "{{NOMBRE COMPLETO}}",
			"input_type": "input",
			"label": "NOMBRE COMPLETO",
			"help_text": "",
			"options": "",
			"required": false,
			"order": 1
		},
		{
			"variable": "{{CNPJ}}",
			"input_type": "input",
			"label": "CNPJ",
			"help_text": "",
			"options": "",
			"required": false,
			"order": 2
		},
		{
			"variable": "{{CPF}}",
			"input_type": "input",
			"label": "CRO",
			"help_text": "",
			"options": "",
			"required": false,
			"order": 3
		}
	],
    "extra_templates": [],
    "notify_extra_emails": "email@email.com",
    "custom_intro": "",
    "youtube_video_code": ""
}
```

{% endtab %}
{% endtabs %}

### Ejemplo de una solicitud en Postman

{% embed url="<https://www.postman.com/zapsign/workspace/zapsign-workspace/request/27495556-6e1e6938-5225-4305-a4bf-d59f78c974d9?ctx=documentation>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zapsign.com.br/espanol/plantillas/actualizar-plantilla.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.