Skip to main content
GET
GET /api/v1/contents/calendar
This endpoint returns editorial planning dates only. It never infers that content was published. Unplanned content is omitted instead of being placed on the calendar by its creation date. Each item includes:
  • planned_for: the stable editorial day in YYYY-MM-DD format.
  • content_state: draft for editable draft/generated content or final for finalized content.
  • date: a compatibility alias for planned_for.
The calendar UI compares planned_for with the browser-local day to show Planned or Overdue. A past date does not change content_state and never creates a Published state.

Publishing-tool handoff

The calendar’s Export plan action downloads a neutral JSON handoff. It does not publish, authorize a social account, or claim delivery.
handoff_status is unsupported when an item has no platform. The export still contains the item and its content_path, so the user can repair the missing platform and export again. Browser download failures remain visible in the calendar and do not change saved planning dates.

Response

Successful response.