ressource.socialbetadocumentation
API referenceComments

One comment thread of a source, oldest first

Flat and cursor-paginated: `parent_comment_id` says where a reply goes. The thread is the public one unless `organization_id` (a community the source is shared in — members only) or `is_note=true` (the owner's notes — the owner only) names another; a thread the caller may not read is 403, a source they cannot open 404.

GET
/api/v1/sources/{id}/comments

Sends a real request with your token. Prefer a read-only token; it is kept in this browser's storage.

Flat and cursor-paginated: parent_comment_id says where a reply goes. The thread is the public one unless organization_id (a community the source is shared in — members only) or is_note=true (the owner's notes — the owner only) names another; a thread the caller may not read is 403, a source they cannot open 404.

Authorization

headerAuthorizationBearer <token>

A personal access token (rsk_…) or a Supabase access token.

Path Parameters

id*string
Length1 <= length

Query Parameters

organization_id?string

A community the source is shared in: that community's thread

Match^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
is_note?string

true: the owner's notes. Not with organization_id

cursor?string
limit?number

Response Body

A page of comments

application/json
  1. response
items*array<>
nextCursor*string|null
hasMore*boolean
curl -X GET 'https://www.ressource.social/api/v1/sources/string/comments'
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "bookmark_id": "49a78d35-bc45-4a39-a336-d00349864577",      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",      "content": "string",      "parent_comment_id": "42e5891d-0323-4706-8826-2064102ce531",      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",      "is_note": true,      "mentions": [        "777c52f7-3433-49cb-b0a3-cd6473c2c951"      ],      "created_at": "string",      "updated_at": "string",      "user": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "username": "string",        "full_name": "string",        "avatar_url": "string"      }    }  ],  "nextCursor": "string",  "hasMore": true}