manage calendars
Authorizations
An API key (es_live_…) from Settings, under API keys, or an OAuth access token.
Headers
Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.
The workspace this one call acts in, when it is not the key's own.
Body
list, get, create, update, delete Calendar name or id, required for get, update and delete.
The word "delete", for delete.
"delete"The calendar's name (create), or its new name (update); its three and their values follow.
get: first day to read, YYYY-MM-DD. Default: the start of this month, the user's time.
get: last day to read, YYYY-MM-DD. Default: the end of the month from falls in.
get: how many entries to read, up to 500. The whole range when left out.
get: next_cursor from the read before, with the same calendar and range.
create or update: channels to offer. A platform the app knows (Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Threads, Pinterest, Twitch, Spotify) gets its own mark and color from the plain name. A name already on the calendar is skipped.
create or update: statuses to offer, in the order work moves through them. A new calendar already has Draft, In review, Approved and Published; pass this only to add to them.
update: rename or recolor a channel. Every item carrying it keeps it.
update: rename or recolor a status.
update: remove these channels, and take them off every item carrying them. The items stay dated.
update: remove these statuses, and clear them off every item carrying them.
update: the order of entries within one day, as a user sets by dragging; a day reads by time first, so this settles entries at the same time or with none. An entry on another day is skipped; moving a day is update_items.
Optional: one sentence shown to the user beside this action.
600
