Scheduling

List Scheduled

List all scheduled posts awaiting publication.

Endpoint

GET https://api.postpeer.dev/v1/posts/scheduled

Example

curl "https://api.postpeer.dev/v1/posts/scheduled" \
  -H "x-access-key: YOUR_API_KEY"

Response

{
  "success": true,
  "posts": [
    {
      "postId": "post_xyz789",
      "content": "This post will go live tomorrow morning!",
      "scheduledFor": "2026-03-29T13:00:00.000Z",
      "timezone": "America/New_York",
      "mediaItems": [],
      "platforms": [
        { "platform": "twitter", "status": "pending" }
      ],
      "createdAt": "2026-03-28T15:00:00.000Z"
    }
  ]
}

Posts are sorted by scheduledFor ascending (next post first).

Status Codes

Code	Meaning
`200`	Success

Schedule Post

Schedule a post for a specific date, time, and timezone.

Reschedule Post

Change the scheduled time of an existing scheduled post.

On this page