scheduling

view your workspace posting schedule and schedule posts for future publication. combine with analytics data to find optimal posting windows.

get_optimal_posting_times

get the workspace configured posting schedule and connected platforms. returns the default schedule, connected platforms, and selected accounts.

> when should i post?
  using antwork.get_optimal_posting_times

  [done] schedule retrieved
  [info] Mon-Fri: 9am, 12pm, 5pm UTC
parameters
workspace_idstringoptional
workspace id or name. optional if user has only one workspace

schedule_post

schedule a post for publishing at a specific time. the post must exist as a draft first.

> schedule my latest draft for tomorrow at 9am
  using antwork.schedule_post

  [done] post scheduled
  [info] scheduled for 2026-04-01T09:00:00Z
parameters
post_idstringrequired
the post id to schedule
scheduled_foriso 8601required
when to publish (e.g. "2026-04-01T10:00:00Z")

get_calendar

get scheduled and published posts as a calendar view, grouped by date. useful for seeing what's coming up and finding gaps in the content schedule.

> show me what's scheduled for next week
  using antwork.get_calendar

  [done] 12 posts across 5 days
  [info] 2026-03-24: 3 posts, 2026-03-25: 2 posts, ...
parameters
date_fromiso 8601optional
start date (e.g., "2026-03-24"). defaults to today
date_toiso 8601optional
end date (e.g., "2026-03-31"). defaults to 7 days from start