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.

Corps (JSON) :
  • project_idobligatoire
  • nameobligatoire
  • descriptionfacultatif
  • prompt_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), name et/ou description. DELETE : project_id + :id dans 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.

Corps (JSON) :
  • project_idobligatoire
  • prompt_idstableau obligatoire
  • tag_idsl’un des deux
  • tag_namesl’un des deux
  • create_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_ids et/ou tag_names (50 tags au maximum).