Editorial Calendar

L'Editorial Calendar est la timeline de ton projet. Au lieu d'entretenir thèmes d'articles, recherches et publications dans des spreadsheets, tu poses les events directement sur un calendrier rattaché au projet — avec date, type, lien optionnel à des articles, mots-clés ou tracking runs. Chaque projet a son propre calendrier, chaque event est team-scoped, tout est lisible et inscriptible via l'API. Le calendrier devient ainsi le point de synchronisation entre rédaction, SEO et automation.

Ce qu'il peut faire

• Calendrier par projet — GET /v1/projects/{project}/calendar liste tous les events d'un projet. Chaque projet a sa propre pipeline éditoriale.
• Types d'event — slots d'article, recherches de mots-clés, dates de publication, tracking runs, actions d'outreach, notes libres. Le type est librement taggable.
• Liens arbitraires — un event peut pointer vers un article, un mot-clé, un tracking run ou une URL externe. La référence reste valide lors des changements de statut.
• CRUD via API — créer, modifier, supprimer les events via PUT/DELETE /v1/calendar/{id}.
• Team-scoping — les lookups cross-team livrent 404, pas de fuite d'existence.
• Combinable avec Automation — les pipelines Autopilot peuvent créer des events (par ex. « chaque mardi 1 article sur le cluster X »).

Quand l'utiliser

• Tu planifies des pipelines de contenu avec des dates de publication claires.
• Tu veux faire tourner les tracking runs (Rank Tracker, AI-Visibility) sciemment de manière rythmée, plutôt qu'ad-hoc.
• Tu travailles avec des rédacteurs qui ne cliquent pas dans l'outil — ils ne voient que le calendrier, tu orchestres derrière.
• Tu as besoin d'une trace d'audit : « quand quoi a été publié / tracké / recherché ? ».

Workflow

1. Choisir un projet — le calendrier est toujours rattaché au projet, pas de vue team-globale.
2. Créer un event — POST /v1/projects/{project}/calendar avec date, type, titre et référence optionnelle (par ex. article_id).
3. Lister — GET /v1/projects/{project}/calendar pour le rendu UI ou outils externes (par ex. sync Notion).
4. Déplacer/modifier — PUT /v1/calendar/{id} change date, titre, statut.
5. Marquer fait ou supprimer — DELETE /v1/calendar/{id} retire définitivement l'event.

Astuce : combine avec Automation — une pipeline peut, lors de la création d'un calendar event, déclencher automatiquement un mandat AI Content Editor.

API

Exemple de body pour POST :

{
  "date": "2026-05-12",
  "type": "article_publish",
  "title": "Stoßdämpfer wechseln — Guide",
  "article_id": 8421
}

Crédits et limites

• Free — tous les endpoints calendar sont gratuits. Seules les actions liées (génération d'article, tracking runs) consomment des crédits dans leurs modules respectifs.
• Team-scoped — toutes les lectures/écritures passent par le filtre currentTeam() ; cross-team → 404.
• Pas de event-cap dur — le calendrier scale via la pagination dans le frontend.
• Intégrité référentielle — si un article lié ou un tracking run est supprimé, le calendar event reste (avec référence invalide, marqué « entrée orpheline » dans l'UI). Tu décides si tu le retires ou si tu le gardes comme trace d'audit.
• Création en bulk — pour les grands plans rédactionnels nous recommandons de créer les events programmatiquement via l'API plutôt qu'individuellement dans l'UI ; l'endpoint POST n'a pas de drossel de fréquence dur au-delà du throttle Sanctum standard.

Modules associés

• AI Content Editor — les calendar events peuvent pointer directement sur des drafts d'article et planifier leur publication.
• Automation — Autopilot et pipelines peuvent créer, modifier ou utiliser comme triggers les calendar events.
• Rank Tracker — les tracking runs planifiés peuvent être rendus visibles comme calendar events.
• Storylines — les étapes de storyline collent 1:1 sur les slots calendar.