Editorial Calendar

El Editorial Calendar es la línea temporal de tu proyecto. En lugar de gestionar temas de artículos, investigaciones y publicaciones en spreadsheets, colocas eventos directamente sobre un calendario vinculado a proyecto — con fecha, tipo, conexión opcional a artículos, palabras clave o tracking-runs. Cada proyecto tiene su propio calendario, cada evento es team-scoped, todo es leíble y escribible vía API. Con eso, el calendario se convierte en el punto de sincronización entre redacción, SEO y Automation.

Qué puede hacer

• Calendario por proyecto — GET /v1/projects/{project}/calendar lista todos los eventos de un proyecto. Cada proyecto tiene su propia editorial pipeline.
• Tipos de evento — slots de artículo, investigaciones de keywords, fechas de publicación, tracking-runs, acciones de outreach, notas libres. El tipo es libre y taggable.
• Vinculaciones libres — un evento puede apuntar a un artículo, una palabra clave, un tracking-run o una URL externa. La referencia se mantiene válida en cambios de estado.
• CRUD vía API — crear, modificar, eliminar eventos vía PUT/DELETE /v1/calendar/{id}.
• Team-Scoping — las consultas cross-team devuelven 404, sin filtración de existencia.
• Combinable con Automation — las pipelines de Autopilot pueden crear eventos (p.ej. «cada martes 1 artículo del Cluster X»).

Cuándo usarlo

• Planeas pipelines de contenido con fechas de publicación claras.
• Quieres que los tracking-runs (Rank-Tracker, AI-Visibility) corran rítmicamente, no ad-hoc.
• Trabajas con redactores que no entran en la herramienta — solo ven el calendario, tú orquestas detrás.
• Necesitas un audit-trail: «¿qué se publicó/trackeó/investigó y cuándo?».

Workflow

1. Selecciona proyecto — el calendario está siempre vinculado a proyecto, no hay vista team-global.
2. Crea evento — POST /v1/projects/{project}/calendar con fecha, tipo, título y referencia opcional (p.ej. article_id).
3. Lista — GET /v1/projects/{project}/calendar para render UI o herramientas externas (p.ej. sync con Notion).
4. Mover/cambiar — PUT /v1/calendar/{id} cambia fecha, título, status.
5. Resolver o eliminar — DELETE /v1/calendar/{id} quita el evento definitivamente.

Tip: combina con Automation — una pipeline puede, al crearse un evento de calendar, disparar automáticamente un job del AI Content Editor.

API

Body de ejemplo para POST:

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

Créditos y límites

• Free — todos los endpoints del calendar son sin coste. Solo las acciones vinculadas (generación de artículos, tracking-runs) consumen créditos en sus respectivos módulos.
• Team-scoped — todos los reads/writes pasan por el filtro currentTeam(); cross-team → 404.
• Sin cap duro de eventos — el calendar escala mediante paginación en el frontend.
• Integridad referencial — si se elimina un artículo o tracking-run vinculado, el evento del calendar permanece (con referencia inválida, marcado en la UI como «entrada huérfana»). Tú decides si lo eliminas o lo mantienes como audit trail.
• Creación bulk — para planes editoriales grandes, recomendamos crear eventos programáticamente vía API en lugar de uno a uno en la UI; el endpoint POST no tiene throttle de frecuencia más allá del estándar de Sanctum.

Módulos relacionados

• AI Content Editor — los eventos del calendar pueden referenciar drafts de artículo y planificar su publicación.
• Automation — Autopilot y Pipelines pueden crear, modificar o usar eventos de calendar como trigger.
• Rank Tracker — los tracking-runs planificados pueden hacerse visibles como eventos de calendar.
• Storylines — las etapas de storyline encajan 1:1 en slots de calendar.