api reference/scheduling
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 workspaceschedule_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 schedulescheduled_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 todaydate_toiso 8601optional
end date (e.g., "2026-03-31"). defaults to 7 days from start