API Reference / Posts

Get a post

PostPiper API: read an owned post by ID, including content, media, platform, account, and current draft, scheduled, published, or failed status.

GEThttps://api.postpiper.ai/v1/posts/{postId}

The response includes the post's attachments, account, timestamps, and platform publication identifiers. Unset scheduling or publication fields are null.

Path and query parameters

Name	Type	Description
postId	UUID, required	ID of an owned post.

Example request

Terminal

curl -H "Authorization: Bearer $POSTPIPER_API_KEY" "https://api.postpiper.ai/v1/posts/<post-uuid>"

Response

200 OK. Returns the post.

JSON

{
  "post": {
    "id": "<post-uuid>",
    "content": "Hello from PostPiper",
    "media_urls": [],
    "asset_ids": [],
    "platform": "x",
    "status": "draft",
    "account_id": "<account-uuid>",
    "created_at": "2030-10-12T01:00:00.000Z",
    "scheduled_at": null,
    "published_at": null,
    "platform_post_id": null,
    "platform_post_url": null
  }
}

Errors

401Missing or invalid API key.
403API key lacks the required scope.
404POST_NOT_FOUND for an unknown or unowned post.