Lister les modèles de votre organisation
/templateclé publiquepuk_Ce service renvoie les modèles automatisés de votre organisation, avec leur id, leur nom et leurs dates. Utilisez l'id pour récupérer un modèle complet avec GET /template?id= ou pour le mettre à jour et le supprimer.
La réponse est un tableau, sans enveloppe ni pagination : elle renvoie tous les modèles en une seule fois, et elle est vide ([]) si l'organisation n'en possède aucun. Les modèles ayant une date de création viennent en premier, du plus récent au plus ancien ; les modèles plus anciens qui n'en ont pas viennent en dernier.
La liste ne renvoie que les modèles gérés via l'API. Ceux créés avec le constructeur Auco n'apparaissent pas.
Authentification
Incluez votre clé publique dans l'en-tête Authorization.
Authorization: puk_xxx...
Paramètres de requête
Ce point de terminaison ne prend aucun paramètre : uniquement l'en-tête d'authentification. Pour récupérer un modèle précis, utilisez GET /template?id=.
🧪 Exemples d'utilisation
Vous pouvez copier n'importe lequel des exemples selon votre langage préféré.
🔹 Lister les modèles
- curl
- Python
- Node.js
curl --location 'https://api.auco.ai/v1.5/ext/template' \
--header 'Authorization: puk_yourPublicKey'
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"])
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();
📥 Exemples de réponse
[
{
"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"
}
]
📋 Champs de la réponse
| Champ | Type | Description |
|---|---|---|
[].id | String | Identifiant du modèle. |
[].name | String | Nom du modèle. |
[].description | String | Facultatif. Texte décrivant le modèle, jusqu'à 500 caractères. Présent uniquement sur les modèles qui le définissent. |
[].createdAt | Date | Facultatif. Date de création, au format ISO 8601. Les modèles plus anciens ne la possèdent pas. |
[].updatedAt | Date | Facultatif. Date de dernière mise à jour, au format ISO 8601. Les modèles plus anciens ne la possèdent pas. |
description, createdAt et updatedAt sont omis lorsque le modèle ne les possède pas : ils ne sont pas renvoyés à null, ils sont simplement absents. Lisez ces clés comme facultatives.
⚠️ Réponses d'erreur
| Code | Description |
|---|---|
401 | Authentification invalide ou absente |
La liste n'a pas d'erreurs de validation : sans paramètres, la seule cause d'échec est la clé. Utilisez la clé publique (puk_) ; la clé privée ne fonctionne pas pour les consultations.