Skip to content
PostFlow

Read the calendar

GET
/calendar
curl --request GET \
  --url 'https://postflow.biz.id/api/v1/calendar?from=2026-04-15T12%3A00%3A00Z&to=2026-04-15T12%3A00%3A00Z' \
  --header 'Authorization: Bearer <token>'

Every post scheduled in [from, to) (at most 92 days) and the queue slots still free in that range.

MCP tool: get_calendar.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
from
required
string format: date-time
to
required
string format: date-time

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
object
timezone
required
string
posts
required
Array<object>
object
id
required
string
caption
required
string
scheduledAt
required
Any of:
string format: date-time
status
required

Derived from the targets.

string
Allowed values: draft scheduled paused publishing published partial failed needs_reschedule action_required
review
required

pending = waiting for the owner’s approval.

string
Allowed values: none pending
version
required

Send as expectedVersion when updating to avoid overwriting someone else’s change.

integer
media
required
Array<object>
object
id
required

Use in mediaIds.

string
kind
required
string
Allowed values: image video
mime
required
string
Allowed values: image/jpeg image/png image/webp image/gif video/mp4 video/quicktime video/webm
sizeBytes
required
integer
width
required
Any of:
integer
height
required
Any of:
integer
durationMs
required
Any of:
integer
originalName
required
string
parentId
required
Any of:

Set on edited copies (e.g. a crop) of another file.

string
url
required

App path of the file. With the API, download it from /media/{id}/file.

string
thumbUrl
required
Any of:
string
createdAt
required
string format: date-time
targets
required
Array<object>

One account a post goes to.

object
id
required

Target id, for retrying one account.

string
socialAccountId
required
string
platform
required
string
Allowed values: facebook instagram tiktok threads bluesky youtube telegram
accountName
required
string
accountAvatarUrl
required
Any of:
string
contentType
required
string
Allowed values: fb_post fb_photo fb_video fb_reel ig_image ig_carousel ig_reel ig_story tt_video tt_photo th_text th_image th_video th_carousel tg_message tg_media bs_post bs_video yt_short yt_video
captionOverride
required
Any of:
string
mediaIds
required
Any of:
Array<string>
options
required

As sent in the request.

object
status
required
string
Allowed values: draft scheduled queued publishing published handed_off failed paused needs_reschedule
errorCode
required
Any of:
string
errorMessage
required
Any of:

Why publishing failed, in plain words.

string
permalink
required
Any of:

Link to the live post.

string
publishedAt
required
Any of:
string format: date-time
firstCommentStatus
required
Any of:
string
Allowed values: pending done failed
tags
required
Array<object>
object
id
required
string
name
required
string
color
required

Hex color

string
repeatDays
required
Any of:
integer
shareToken
required
Any of:

Set while a public preview link exists.

string
clientApprovedAt
required
Any of:
string format: date-time
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
freeSlots
required

Queue slots in the range with no post within 30 minutes.

Array<object>
object
at
required

The slot’s time.

string format: date-time
label
required

E.g. “Tue 09:00” in the workspace time zone

string

Example 

{
  "posts": [
    {
      "status": "draft",
      "review": "none",
      "media": [
        {
          "kind": "image",
          "mime": "image/jpeg"
        }
      ],
      "targets": [
        {
          "platform": "facebook",
          "contentType": "fb_post",
          "status": "draft",
          "firstCommentStatus": "pending"
        }
      ]
    }
  ]
}

400

Section titled “400”

Validation failed. details lists what to fix.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

401

Section titled “401”

Missing, invalid, expired or deleted key or token.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}

429

Section titled “429”

More than 120 requests in a minute with this key.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: UNAUTHENTICATED FORBIDDEN NOT_FOUND VALIDATION CONFLICT SUBSCRIPTION_GRACE SUBSCRIPTION_EXPIRED PLAN_LIMIT RATE_LIMITED INTERNAL
message
required

A sentence you can show to a person.

string
details

Field errors ({ field: [messages] }), or preflight: per-account rule violations with an issue code.

Example 

{
  "error": {
    "code": "UNAUTHENTICATED"
  }
}
© 2026 PostFlow