Lista las plantillas de tu organización

GET/templatellave públicapuk_

Este servicio devuelve las plantillas automatizadas de tu organización, con su id, nombre y fechas. Usa el id para consultar una plantilla completa con GET /template?id= o para actualizarla y eliminarla.

La respuesta es un arreglo, sin envoltorio ni paginación: trae todas las plantillas de una vez, y viene vacío ([]) si la organización no tiene ninguna. Las que tienen fecha de creación van primero, de la más reciente a la más antigua; las plantillas antiguas que no la tienen van al final.

No incluye las plantillas creadas con el constructor de Auco

El listado solo trae las plantillas que se gestionan por el API. Las creadas con el constructor de Auco no aparecen.

---

Autenticación

Incluye tu llave publica en el encabezado Authorization.

Authorization: puk_xxx...

---

Parámetros de consulta

Este endpoint no recibe parámetros: solo el encabezado de autenticación. Para consultar una plantilla concreta, usa GET /template?id=.

---

🧪 Ejemplos de uso

tip

Puedes copiar cualquiera de los ejemplos según el lenguaje de tu preferencia.

🔹 Listar las plantillas

curl

curl --location 'https://api.auco.ai/v1.5/ext/template' \
  --header 'Authorization: puk_tuClavePublica'

Python

import requests

response = requests.get(
    "https://api.auco.ai/v1.5/ext/template",
    headers={"Authorization": "puk_tuClavePublica"},
)
response.raise_for_status()

for template in response.json():
    print(template["id"], template["name"])

Node.js

const axios = require('axios');

async function listTemplates() {
  const response = await axios.get('https://api.auco.ai/v1.5/ext/template', {
    headers: { Authorization: 'puk_tuClavePublica' },
  });

  for (const template of response.data) {
    console.log(template.id, template.name);
  }
}

listTemplates();

---

📥 Ejemplos de respuesta

[
  {
    "id": "64823dc5ce28a265e02d68f3",
    "name": "Contrato de servicios",
    "description": "Contrato de servicios con un firmante, para el equipo comercial",
    "createdAt": "2025-11-26T20:48:00.000Z",
    "updatedAt": "2025-11-27T09:30:00.000Z"
  },
  {
    "id": "64823dc5ce28a265e02d68f4",
    "name": "Contrato de compraventa",
    "createdAt": "2025-11-20T15:10:00.000Z",
    "updatedAt": "2025-11-20T15:10:00.000Z"
  }
]

---

📋 Campos de la respuesta

Campo	Tipo	Descripción
[].id	String	Identificador de la plantilla.
[].name	String	Nombre de la plantilla.
[].description	String	Opcional. Texto que describe la plantilla, hasta 500 caracteres. Solo viene en las plantillas que lo tienen definido.
[].createdAt	Date	Opcional. Fecha de creación, en ISO 8601. Las plantillas antiguas no la tienen.
[].updatedAt	Date	Opcional. Fecha de la última actualización, en ISO 8601. Las plantillas antiguas no la tienen.

No asumas que todos los campos vienen

description, createdAt y updatedAt se omiten cuando la plantilla no los tiene: no vienen como null, simplemente no están. Lee esas claves de forma opcional.

---

⚠️ Respuestas de error

Código	Descripción
401	Autenticación inválida o ausente

El listado no tiene errores de validación: sin parámetros, la única forma de que falle es la llave. Usa la llave pública (puk_); la privada no sirve para consultar.