Listar os modelos da sua organização

GET/templatechave públicapuk_

Este serviço retorna os modelos automatizados da sua organização, com seu id, nome e datas. Use o id para obter um modelo completo com GET /template?id= ou para atualizá-lo e excluí-lo.

A resposta é um array, sem envelope e sem paginação: retorna todos os modelos de uma só vez e fica vazia ([]) se a organização não tiver nenhum. Os modelos com data de criação vêm primeiro, do mais recente ao mais antigo; os modelos mais antigos sem ela vêm por último.

Os modelos criados com o construtor da Auco não são incluídos

A lista retorna apenas os modelos gerenciados pela API. Os criados com o construtor da Auco não aparecem.

---

Autenticação

Inclua sua chave pública no cabeçalho Authorization.

Authorization: puk_xxx...

---

Parâmetros de consulta

Este endpoint não recebe parâmetros: apenas o cabeçalho de autenticação. Para obter um modelo específico, use GET /template?id=.

---

🧪 Exemplos de uso

dica

Você pode copiar qualquer um dos exemplos conforme a sua linguagem preferida.

🔹 Listar os modelos

curl

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

Python

import requests

response = requests.get(
    "https://api.auco.ai/v1.5/ext/template",
    headers={"Authorization": "puk_yourPublicKey"},
)
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_yourPublicKey' },
  });

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

listTemplates();

---

📥 Exemplos de resposta

[
  {
    "id": "64823dc5ce28a265e02d68f3",
    "name": "Service Agreement",
    "description": "Service agreement with one signer, for the sales team",
    "createdAt": "2025-11-26T20:48:00.000Z",
    "updatedAt": "2025-11-27T09:30:00.000Z"
  },
  {
    "id": "64823dc5ce28a265e02d68f4",
    "name": "Purchase Agreement",
    "createdAt": "2025-11-20T15:10:00.000Z",
    "updatedAt": "2025-11-20T15:10:00.000Z"
  }
]

---

📋 Campos da resposta

Campo	Tipo	Descrição
[].id	String	Identificador do modelo.
[].name	String	Nome do modelo.
[].description	String	Opcional. Texto que descreve o modelo, com até 500 caracteres. Presente apenas nos modelos que o definem.
[].createdAt	Date	Opcional. Data de criação, em ISO 8601. Os modelos mais antigos não a possuem.
[].updatedAt	Date	Opcional. Data da última atualização, em ISO 8601. Os modelos mais antigos não a possuem.

Não presuma que todos os campos estão presentes

description, createdAt e updatedAt são omitidos quando o modelo não os possui: não vêm como null, simplesmente estão ausentes. Trate essas chaves como opcionais.

---

⚠️ Respostas de erro

Código	Descrição
401	Autenticação inválida ou ausente

A listagem não tem erros de validação: sem parâmetros, a única forma de falhar é pela chave. Use a chave pública (puk_); a chave privada não funciona para consultas.