Calendar API
The Calendar API gives you a single view of your scheduled and posted social content. Each entry represents a clip queued for publishing or already delivered to a connected platform. Use these endpoints to list calendar entries, reschedule or update a post with PATCH, and cancel a pending post with DELETE.
Conventions
Requests use the base URL https://api.vdclip.com with the Authorization: Bearer vdck_... header. The API is server-to-server only and has no CORS.
Successful responses return resource data directly. Errors return an errors array. The list endpoint pages with a cursor plus limit; follow the returned cursor.
Reschedule and cancel apply only to pending posts. Once a post is delivered it cannot be unsent, so a PATCH or DELETE against an already posted entry is rejected. Reading the calendar requires the vdclip:calendar:read scope; rescheduling and cancelling require vdclip:calendar:write. A missing scope returns MISSING_SCOPE, and an unknown post id returns NOT_FOUND.
Endpoints
Reschedule/update a scheduled post
PATCH /v1/calendar/{post_id}