Aller au contenu principal

Lister les modèles de votre organisation

GET/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.

Les modèles créés avec le constructeur Auco ne sont pas inclus

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​

astuce

Vous pouvez copier n'importe lequel des exemples selon votre langage préféré.

🔹 Lister les modèles​

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

📥 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​

ChampTypeDescription
[].idStringIdentifiant du modèle.
[].nameStringNom du modèle.
[].descriptionStringFacultatif. Texte décrivant le modèle, jusqu'à 500 caractères. Présent uniquement sur les modèles qui le définissent.
[].createdAtDateFacultatif. Date de création, au format ISO 8601. Les modèles plus anciens ne la possèdent pas.
[].updatedAtDateFacultatif. Date de dernière mise à jour, au format ISO 8601. Les modèles plus anciens ne la possèdent pas.
Ne supposez pas que tous les champs sont présents

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​

CodeDescription
401Authentification 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.