Autopilot

Let Posttar create and publish on a weekly schedule.

View as Markdown Open in Claude Open in ChatGPT

Autopilot creates and publishes on its own, on a weekly grid of slots. Each slot is a weekday (dayOfWeek, 0 for Monday), a whole hour in the project's timezone (hour), and an optional theme for what to write about. Without a theme, autopilot picks the topic.

Read the current grid:

curl -H "Authorization: Bearer $POSTTAR_KEY" "https://api.posttar.com/v1/projects/c85848ba-.../autopilot"

{
  "projectId": "c85848ba-...",
  "enabled": false,
  "emailReport": true,
  "requiresApproval": false,
  "timezone": "America/Sao_Paulo",
  "slots": [],
  "blockers": ["no_slots", "no_instagram"]
}

blockers is the useful field: it lists what is stopping autopilot from running. no_slots means the grid is empty, no_instagram means the project has no connected account, no_subscription means the plan lapsed. Turning it on while a blocker stands will not make it publish.

Set up a weekly schedule

Add slots, then turn it on.

Add a slot: Tuesday at 09:00. dayOfWeek counts from Monday as 0.

curl -X POST -H "Authorization: Bearer $POSTTAR_KEY" -H "Content-Type: application/json" \
  -d '{"dayOfWeek":1,"hour":9,"theme":"a practical tip, no jargon"}' \
  "https://api.posttar.com/v1/projects/c85848ba-.../autopilot/slots"

Turn autopilot on.

curl -X POST -H "Authorization: Bearer $POSTTAR_KEY" \
  "https://api.posttar.com/v1/projects/c85848ba-.../autopilot/enable"

Check that no impediment is left.

curl -H "Authorization: Bearer $POSTTAR_KEY" "https://api.posttar.com/v1/projects/c85848ba-.../autopilot"

With requiresApproval on, autopilot creates the post and stops at draft instead of publishing. Use it when you want a human to look before anything goes out.