info:
  name: Reports
  type: folder
  seq: 3
  description: Rapports email planifiés et alertes de changement de position sur un tracking.

docs: |-
  Un *report* est un envoi email planifié attaché à un tracking : hebdomadaire, mensuel, ou
  alerte de changement de position. Il porte un `type`, un `name` et une liste d'`emails`
  destinataires.

  À la création d'un tracking, des rapports **hebdomadaire et mensuel par défaut sont générés
  automatiquement** — `Get all reports` en retournera donc même sans en avoir créé.

  ## Réserves sur la documentation

  - **Les valeurs numériques de `type` ne sont pas publiées.** La doc dit seulement que le
    champ distingue hebdomadaire, mensuel et alerte de changement de position, sans donner la
    correspondance. Lis un rapport existant via `Get all reports` pour découvrir les valeurs
    réellement utilisées par ton compte.
  - **Les valeurs de `triggers` ne sont pas publiées non plus.** Le champ est décrit comme un
    « tableau optionnel de types de déclencheurs pour les rapports d'alerte », sans énumération.
  - La page `Update report` ne redétaille pas les contraintes des champs : elle renvoie
    implicitement au schéma de la création.

  ## Codes de succès

  Lecture et création en `200`, mise à jour et suppression en `204` — cohérent au sein de ce
  dossier, contrairement au dossier `tags`.