PostliftDevelopers
Documentation menu
Posts & scheduling

restore 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}/restore
Example requestcURL
curl -X POST 'https://postlift.io/api/v1/posts/{id}/restore' \
  -H "Authorization: Bearer $POSTLIFT_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "version": 1
}'

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

NameLocationDescription
idrequiredpathPostlift resource ID belonging to the API key owner.

Request body

Send JSON with Content-Type: application/json.

FieldType & constraints
versionrequiredintegerMaximum: 9007199254740991.
View JSON schema
{
  "type": "object",
  "properties": {
    "version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "version"
  ],
  "additionalProperties": false
}

Response

200 Successful operation.

FieldType & constraints
postrequiredPost ↗
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.

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