Social API reference

Social API · Comments

delete/v1/communities/{community_id}/posts/{post_id}/comments/{comment_id}/pinAuth

Unpin a comment (post-author only).

Clears the pin; the comment returns to its chronological position. Reserved to the post author (403). Idempotent. Pass the acting actor via the request body.

Path parameters

community_id*string

Social community UUID. Must belong to the PAK's workspace.

post_id*string

Social post UUID the comments thread under.

comment_id*string

Social comment UUID.

Request body

actor_id*string · uuid

The acting actor — must equal the post.actor_id (task 012).

Example: "aaaaaaaa-0000-0000-0000-000000000001"

Response · 200 Comment unpinned.

id*string · uuid

Comment UUID.

Example: "bbbbbbbb-0000-0000-0000-000000000001"

community_id*string · uuid

Owning community UUID.

Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"

post_id*string · uuid

Post the comment threads under.

Example: "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb"

parent_id*string · uuid

Parent comment UUID for replies; `null` for top-level.

Example: null

actor_id*string · uuid

Comment author actor UUID.

Example: "aaaaaaaa-0000-0000-0000-000000000001"

body*string

Comment body.

Example: "Looks great, shipping today."

depth*number

Thread depth — 0 for top-level, 1 for first reply, etc. Capped per community.

Example: 0

status*object

Lifecycle status. `pending_approval` = held by restricted-commenter pre-moderation; list endpoints surface these rows only to the comment author and the post-author (who publishes them via POST :commentId/approve). `removed` rows are hidden from public reads.

Example: "published"

visibility*object

`public` (default) is visible to anyone who can read the post; `author_only` is DM-style (post-author + comment-author only).

Example: "public"

reaction_counts*object

Map of reaction type to count, denormalised on the comment row in lock-step with the comment-reaction writes.

Example: {"like":2}

pinned*boolean

True when the post author has pinned this top-level comment (task 012). Pinned comments lead the top-level listing.

Example: false

pinned_at*string · date-time

ISO timestamp the comment was pinned; null when not pinned.

Example: null

assets*array

Ordered image attachments (task 019). Ref-only; resolve renditions via GET /assets/:id.

created_at*string · date-time

ISO timestamp the row was inserted.

Example: "2026-05-01T12:00:00.000Z"

updated_at*string · date-time

ISO timestamp of the last update.

Example: "2026-05-01T12:00:00.000Z"

Example

Request

DELETE https://social.productcraft.co/v1/communities/{community_id}/posts/{post_id}/comments/{comment_id}/pin
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "actor_id": "aaaaaaaa-0000-0000-0000-000000000001"
}

Response

{
  "id": "bbbbbbbb-0000-0000-0000-000000000001",
  "community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "post_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
  "parent_id": null,
  "actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
  "body": "Looks great, shipping today.",
  "depth": 0,
  "status": "published",
  "visibility": "public",
  "reaction_counts": {
    "like": 2
  },
  "pinned": false,
  "pinned_at": 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"
}