/v1/communities/{community_id}/posts/{post_id}AuthGet a post by id. Visibility-aware: pass `actor_id` for non-public posts.
Without `actor_id`, only `public` posts return. With one, `followers` / `close_friends` / the requester's own `private` posts surface per the visibility matrix. Returns 404 (opacity) when the requester is not allowed to read the post — never 403.
Path parameters
community_id*stringSocial community UUID. Must belong to the PAK's workspace.
post_id*stringSocial post UUID.
Query parameters
actor_idstring · uuidSocial actor UUID of the viewer. Surfaces non-public posts they are entitled to see.
Response · 200 Post.
id*string · uuidPost UUID.
Example: "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"
community_id*string · uuidOwning community UUID.
Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"
actor_id*string · uuidAuthor actor UUID.
Example: "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
kind*stringFree-form post kind. Common: text, link, image, story, repost, quote.
Example: "text"
title*stringOptional title (1-240 chars).
Example: "Shipping Phase 8"
body*stringBody markdown / plain text (up to 50000 chars).
Example: "Stories are live!"
url*stringOptional URL.
Example: "https://cdn.example.com/img.png"
attributes*objectFree-form attributes blob (polls live at `attributes.poll`).
Example: {}
visibility*objectVisibility scope.
Example: "public"
status*objectLifecycle status. Public list/feed surfaces only return `published`; `draft`, `scheduled`, and `archived` rows surface exclusively on their author-scoped listings and author reads. `removed` rows are hidden from reads. `archived` keeps engagement but is author-only.
Example: "published"
reaction_counts*objectMap of reaction type to count, denormalised on the post row for cheap feed reads.
Example: {"like":12,"fire":3}
comment_count*numberComment count, denormalised on the post row.
Example: 4
source_post_id*string · uuidFor kind='repost' / 'quote': the source post UUID.
Example: null
repost_count*numberDenormalised count of currently-published reposts.
Example: 0
quote_count*numberDenormalised count of currently-published quote posts.
Example: 0
edited_at*string · date-timeISO timestamp of the most recent edit (body/title/attributes change). Null when never edited.
Example: null
edit_count*numberNumber of edits applied; equals the count of post_revision rows.
Example: 0
view_count*numberDenormalised impression count, bumped via the batch POST /posts/views endpoint.
Example: 0
expires_at*string · date-timeISO timestamp; `null` = no expiry. Stories typically set this 24h ahead.
Example: null
pinned*booleanWhen `true`, surfaces in the author's highlights endpoint regardless of expiry.
Example: false
settings*objectTyped per-post interaction settings (comment policy, count hiding, repost/quote permission). Enforced server-side.
scheduled_for*stringISO publish-at timestamp, set while status='scheduled'. The scheduler cron promotes the post to published and clears this field; a manual PATCH promotion leaves the last value in place unless the caller also passes scheduled_for: null.
Example: null
assets*arrayOrdered image attachments (task 019). Ref-only; resolve renditions via GET /assets/:id.
created_at*string · date-timeISO timestamp the row was inserted.
Example: "2026-05-01T12:00:00.000Z"
updated_at*string · date-timeISO timestamp of the last update.
Example: "2026-05-01T12:00:00.000Z"
Example
Request
GET https://social.productcraft.co/v1/communities/{community_id}/posts/{post_id}
Authorization: Bearer YOUR_TOKENResponse
{
"id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
"community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
"actor_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
"kind": "text",
"title": "Shipping Phase 8",
"body": "Stories are live!",
"url": "https://cdn.example.com/img.png",
"attributes": {},
"visibility": "public",
"status": "published",
"reaction_counts": {
"like": 12,
"fire": 3
},
"comment_count": 4,
"source_post_id": null,
"repost_count": 0,
"quote_count": 0,
"edited_at": null,
"edit_count": 0,
"view_count": 0,
"expires_at": null,
"pinned": false,
"settings": {},
"scheduled_for": null,
"assets": [
{
"asset_id": "eeeeeeee-0000-0000-0000-000000000001",
"alt_text": "A golden retriever on a beach"
}
],
"created_at": "2026-05-01T12:00:00.000Z",
"updated_at": "2026-05-01T12:00:00.000Z"
}