Collections et tags
Les collections (appelées tags dans l’application) regroupent les prompts par thème, étape du tunnel de conversion ou campagne, pour que toutes les métriques puissent être filtrées par collection. Un prompt peut appartenir à plusieurs collections.
GET/dimensions/collections
Liste les tags du projet (appelés collections dans l’API).
GET/dimensions/tags
Alias de /dimensions/collections. Renvoie le même payload, mais sous le nom tags, par cohérence avec l’interface.
POST/collections
Crée un tag (Collection) dans un projet. Peut aussi y associer des prompts existants dans le même appel. Le nom d’un tag est unique dans le projet, sans tenir compte de la casse.
project_idobligatoirenameobligatoiredescriptionfacultatifprompt_idstableau facultatif, les prompts doivent appartenir au projet
PATCH/DELETE /collections/:id
Renomme un tag, modifie sa description ou le supprime. Supprimer un tag conserve les prompts qu’il contient : seul le regroupement disparaît. L’appartenance des prompts aux tags se gère via POST /prompts/assign_tags et POST /prompts/remove_tags.
- Corps PATCH :
project_id(obligatoire),nameet/oudescription. DELETE :project_id+:iddans l’URL.
POST/prompts/assign_tags
Ajout idempotent de tags en masse à des prompts existants. Les tags peuvent être désignés par leur identifiant ou par leur nom.
project_idobligatoireprompt_idstableau obligatoiretag_idsl’un des deuxtag_namesl’un des deuxcreate_missingbooléen facultatif, crée automatiquement les tags dont le nom est inconnu
POST/prompts/remove_tags
Retrait idempotent de tags en masse sur des prompts existants. Seules les associations sont supprimées : les tags et les prompts sont conservés.
- Corps (JSON) :
project_id(obligatoire),prompt_ids(tableau obligatoire, 500 au maximum),tag_idset/outag_names(50 tags au maximum).