Skip to main content
Manage the workspace posting queue. Auth: X-API-Key or JWT + X-Workspace-Id. Requires scheduling_enabled.

​
Endpoints

MethodPathDescription
POST/unified/scheduled-postsSchedule-only create (scheduled_time required)
GET/unified/scheduled-postsList queue
PATCH/unified/scheduled-posts/{id}Update
DELETE/unified/scheduled-posts/{id}Cancel / delete
POST/unified/scheduled-posts/{id}/publish-nowPublish immediately
POST/unified/scheduled-posts/{id}/move-to-draftConvert to draft

​
Create

Body shape matches unified post endpoints (post_type, platforms, media fields, platform overrides) plus required scheduled_time. 
curl -X POST "https://backend.postsiva.com/unified/scheduled-posts" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: psk_live_YOUR_KEY" \
  -d '{
    "post_type": "text",
    "platforms": ["linkedin"],
    "default_text": "Queued for tomorrow.",
    "scheduled_time": "2026-07-10T14:30:00Z"
  }'
Does not accept draft / draft_platforms — use POST /unified/post/* for those.

​
List

curl "https://backend.postsiva.com/unified/scheduled-posts?status=scheduled&limit=20" \
  -H "X-API-Key: psk_live_YOUR_KEY"
QueryDescription
platforme.g. linkedin
platform_user_idPage / org / account id
statusscheduled, published, failed, cancelled, publishing
limit / offsetPagination

​
Guide

See Scheduling for scheduled_time on post endpoints and timezone notes.