Posts & scheduling

schedule a post

Use this endpoint from your own integration, with the same account permissions and safeguards as the app.

Scope · posts:write

Request

POST/api/v1/posts/{id}/schedule

Example requestcURL

curl -X POST 'https://postlift.io/api/v1/posts/{id}/schedule' \
  -H "Authorization: Bearer $POSTLIFT_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "version": 1,
  "scheduledAt": 1893456000000,
  "timezone": "UTC"
}'

Replace path placeholders with your Postlift resource IDs. Example timestamps must be replaced with a future time; preserve the same timestamp when retrying the same operation.

Parameters

Name	Location	Description
`id`required	path	Postlift resource ID belonging to the API key owner.

Request body

Send JSON with Content-Type: application/json.

Field	Type & constraints
`version`required	integerMaximum: 9007199254740991.
`scheduledAt`required	integerMaximum: 9007199254740991.
`timezone`optional	stringDefault: "UTC". Max. characters: 64.

View JSON schema

{
  "type": "object",
  "properties": {
    "version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "scheduledAt": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "timezone": {
      "default": "UTC",
      "type": "string",
      "maxLength": 64
    }
  },
  "required": [
    "version",
    "scheduledAt"
  ],
  "additionalProperties": false
}

Response

200 Successful operation.

Field	Type & constraints
`post`required	Post ↗

Explore PostEnvelope ↗

View JSON schema

{
  "type": "object",
  "properties": {
    "post": {
      "$ref": "#/components/schemas/Post"
    }
  },
  "required": [
    "post"
  ],
  "additionalProperties": true
}

Errors & retries

Failures use a stable error code and request ID. Check the current resource version or request status before retrying a write.

Status	Meaning
`400`	Invalid input or Jev rejection
`401`	Invalid, expired or revoked API key
`402`	Plan, publishing quota or AI credit requirement
`403`	Missing scope
`404`	Resource not found or not owned
`409`	Version conflict, missing voice or duplicate AI operation
`413`	Payload too large
`429`	Rate or concurrency limit
`500`	Internal error
`502`	Upstream failure; inspect operation status
`503`	Service or review unavailable

Read the retry guide ↗