Skip to main content
GET
/
api
/
calendar
/
posts
/
{postId}
Get a single social post
curl --request GET \
  --url https://app.puffle.ai/api/calendar/posts/{postId} \
  --header 'Authorization: Bearer <token>'
{
  "post": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "calendar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "<string>",
    "content": "<string>",
    "hashtags": [
      "<string>"
    ],
    "channels": [
      "<string>"
    ],
    "scheduled_at": "2023-11-07T05:31:56Z",
    "account_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "status": "draft",
    "late_post_id": "<string>",
    "media_items": [
      {
        "url": "<string>",
        "type": "image"
      }
    ],
    "archived_at": "2023-11-07T05:31:56Z"
  }
}

​
Overview

Returns the raw post row by path-param id. No account enrichment — for enriched list data, use listSocialPosts instead.

​
AI agent notes

Scoped to the caller’s calendar. Posts that aren’t in the caller’s calendar return 404 even if they exist elsewhere.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
postId
string<uuid>
required

Post UUID. Must belong to the caller's calendar.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Post found.

​
post
object
required