Returns the next batch of article titles, the same ones the Plan Content button shows. Each title comes with its topic, format, search and day on the calendar. Defaults to a DRY RUN: nothing goes on the calendar. When the person asked to add them, call it with confirm=true. To add only some, pass their ids in keep. Set news=true for this week's news titles, the ones Plan Content's news list shows. They are written every Monday for paid workspaces with News or Trending on, and go on the calendar one a day. To plan titles about something specific, pass it as subject with the workspace topics it fits as topics. Add the ones the person wants with commit_planned_titles. If the subject fits none of the topics, offer to add a topic first (set_topics). Capped at 5/min.

Requires the write:content scope.

post/api/v1/content/plan

Request

  • Base URL: https://api.rctrl.com
  • URL: https://api.rctrl.com/api/v1/content/plan
  • Auth: HTTP bearer

Request body

subjectstring

What the titles should be about, in the user's words (150 characters max). Needs topics.

topicsstring[]

The topics the subject fits, from get_topics

newsboolean

true: this week's news instead of the next batch. Works with keep and confirm.

keepstring[]

Ids from the dry run to add. Leave it out to add the whole batch. Titles you leave out stay for a later batch.

confirmboolean

Set true to add the titles to the calendar (default: dry run)

Response

Success; the payload is wrapped in a data envelope

dataunknown

Changes

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