List Your Organization's Templates

GET/templatepublic keypuk_

This service returns your organization's automated templates, with their id, name and dates. Use the id to fetch a full template with GET /template?id= or to update and delete it.

The response is an array, with no wrapper and no pagination: it returns every template at once, and it is empty ([]) if the organization has none. Templates with a creation date come first, newest to oldest; older templates without one come last.

Templates created with the Auco builder are not included

The list only returns templates managed through the API. Those created with the Auco builder do not appear.

---

Authentication

Include your public key in the Authorization header.

Authorization: puk_xxx...

---

Query Parameters

This endpoint takes no parameters: only the authentication header. To fetch a specific template, use GET /template?id=.

---

🧪 Usage Examples

tip

You can copy any of the examples depending on your preferred language.

🔹 List the templates

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();

---

📥 Response Examples

[
  {
    "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"
  }
]

---

📋 Response Fields

Field	Type	Description
[].id	String	Template identifier.
[].name	String	Template name.
[].description	String	Optional. Text describing the template, up to 500 characters. Only present on templates that define it.
[].createdAt	Date	Optional. Creation date, in ISO 8601. Older templates do not have it.
[].updatedAt	Date	Optional. Last update date, in ISO 8601. Older templates do not have it.

Do not assume every field is present

description, createdAt and updatedAt are omitted when the template does not have them: they do not come as null, they are simply absent. Read those keys as optional.

---

⚠️ Error Responses

Code	Description
401	Invalid or missing authentication

The list has no validation errors: with no parameters, the only way it fails is the key. Use the public key (puk_); the private key does not work for queries.