API Reference
Schedules
Create and manage future pin publishing operations.
Overview
Schedules let you queue future publishes with UTC timestamps and the same media options used by direct pin creation.
What You Will Learn
- run_at must include timezone info and be in the future.
- Media and cover image field rules mirror pin creation payloads.
- Schedules can be canceled while in scheduled/queued states.
Implementation Checklist
- Convert local user time to UTC before sending run_at.
- Use asset_id for uploaded media and optional cover_image_asset_id for video covers.
- Monitor scheduled items and cancel before execution windows when needed.
Relevant Endpoints
POST
/v1/schedulesCreate a scheduled publish operation.
GET
/v1/schedulesList schedules for the active workspace.
GET
/v1/schedules/{schedule_id}Fetch one schedule resource.
POST
/v1/schedules/{schedule_id}/cancelCancel a pending schedule.