Content

Get or create a monthly content calendar

Returns persisted calendar items for a month. For V3 projects, explicitly send setup=true when the user requests planning; omit setup and refresh for reads and polling. Empty V3 calendars do not auto-start. Only poll while data.status is generating, waiting retry_after_seconds. Respect planning_outcome restrictions. Use refresh=true to explicitly retry or continue an existing V3 strategy, not initial setup. Legacy empty eligible months retain automatic generation. Planning does not generate articles or enable publishing.

post/v1/projects/{projectId}/content-calendar

Request

  • Base URL: https://www.seoforgpt.io/api
  • URL: https://www.seoforgpt.io/api/v1/projects/{projectId}/content-calendar
  • Auth: HTTP bearer

Path parameters

projectIdstring uuid required

Request body

planningMonthstring

Calendar month in YYYY-MM format; defaults to the current UTC month.

setupboolean

Explicitly build a V3 calendar, including when seed recommendations already exist. Omit for retrieval or polling. Does not generate articles or enable publishing.

previewSetupboolean

Return a read-only setup preview with period, affected topics and revision.

existingRecommendations'keep' | 'replace_untouched'

Replacement requires explicit user confirmation of the preview, setup=true and previewRevision.

previewRevisionstring

Revision from the setup preview confirmed by the user.

refreshboolean

Retry generation only when the selected current or future month previously completed with zero items.

Response

Existing, created, empty, or not-ready calendar

metaBillingMeta

Plan and quota snapshot (shape may evolve)

Changes

No recorded changes to this operation across all 1 revision of this API.