Posts
32 routes. Paths are relative to https://api.intersink.com/v1. This group belongs to a feature in beta.
- POST/postsCreate a new post
- GET/posts/{id}One public post of the channel (x-ref / X-App-Key), with media, counts and the viewer's like
- PATCH/posts/{id}Update my post
- DELETE/posts/{id}Delete my post
- GET/posts/{id}/commentsFetch comments and replies for a post
- POST/posts/{id}/commentsAdd a comment or reply to a post
- POST/posts/{id}/dislikeDislike or Un-dislike a post
- POST/posts/{id}/donateMake a donation on a post
- GET/posts/{id}/donationsGet all donations for a post
- POST/posts/{id}/filesAttach a file to a post
- DELETE/posts/{id}/files/{file_id}Remove a file from a post
- POST/posts/{id}/files/bulkAttach multiple files to a post in bulk
- POST/posts/{id}/likeLike or Unlike a post
- GET/posts/{id}/likesProfiles who liked a post + total count (drawer)
- POST/posts/{id}/repostRepost, quote-repost, or unrepost a post
- GET/posts/{id}/repostsProfiles who reposted a post + total count (drawer)
- POST/posts/{id}/saveSave or Unsave a post
- POST/posts/{id}/shareShare or Unshare a post
- GET/posts/{id}/sharesProfiles who shared a post + total share count
- POST/posts/{id}/viewRecord a post view (deduplicated per viewer)
- PATCH/posts/comment/{id}Update my comment
- DELETE/posts/comment/{id}Delete my comment
- POST/posts/comment/{id}/likeLike or Unlike a comment
- GET/posts/comments/myFetch all comments written by me
- GET/posts/followingGet posts feed only from followed profiles
- GET/posts/likes/myFetch all posts liked by me
- GET/posts/myFetch all my posts
- GET/posts/my/{id}Fetch a single post of mine
- GET/posts/profile/{profileId}Get a profile's combined feed: its own posts + reposts (with attribution)
- GET/posts/reposts/myFetch all posts reposted by me
- GET/posts/saves/myFetch all posts saved by me
- GET/posts/trendingGet trending posts feed based on views, comments, and likes
Create a new post
POST/posts
Needs a signed-in user (Bearer token or access_token cookie).
Request body application/json
| Field | Type | Description |
|---|---|---|
| titlerequired | string | Title of the post At most 255 characters. |
| description | string | Main description/content of the post |
| sub_description | string | Sub description of the post |
| meta_title | string | Meta title for SEO At most 255 characters. |
| meta_description | string | Meta description for SEO |
| meta_keywords | string | Meta keywords for SEO At most 255 characters. |
| location | string | Coordinates as "lat,lng", stored rounded to about 110 m. Leave it out when unknown: no default city is ever filled in, and a post with no place of its own gets location null (or its channel business city, marked source: "channel"). At most 255 characters. |
| place | string | Where it was posted, for people ("Shoreditch, London") At most 120 characters. |
| parent_id | string | Parent Post ID if it is a reply or sub-post |
| download_link | string | Download link if applicable At most 255 characters. |
| project_link | string | Project link if applicable At most 255 characters. |
| requires | string | Requirements or prerequisites At most 255 characters. |
| transcript | string | Transcript text if video/audio |
| attribute | string | Post attributes/tags |
| type | string | Post type (e.g., post, article, video). campaign/event/job/fundraiser are reserved. At most 255 characters. |
| group_id | string | Post into a community group (members only; never public) |
| public | boolean | Is this post public? |
| fee | object | Fee amount if applicable |
| topic | string | Topic ID |
| hashtags | string | Hashtags (comma-separated string) At most 255 characters. |
| downloads | object | Downloads count |
| users | string | Users (comma-separated UUIDs) |
| status | string | Post status: draft or published (moderation may hold it) One of: "draft", "published". |
| published | string | Published date/time |
| active_profile_id | string | Profile to post as (must belong to the caller; defaults to the session profile) |
Response
201. The payload in data is not described in the spec yet.
One public post of the channel (x-ref / X-App-Key), with media, counts and the viewer's like
GET/posts/{id}
Public: no sign-in needed.
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| active_profile_idrequired | string, query |
Response
200. The payload in data is of type object.
Update my post
PATCH/posts/{id}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Request body application/json
| Field | Type | Description |
|---|---|---|
| title | string | Title of the post At most 255 characters. |
| description | string | Main description/content of the post |
| sub_description | string | Sub description of the post |
| meta_title | string | Meta title for SEO At most 255 characters. |
| meta_description | string | Meta description for SEO |
| meta_keywords | string | Meta keywords for SEO At most 255 characters. |
| location | string | Coordinates as "lat,lng", stored rounded to about 110 m. Leave it out when unknown: no default city is ever filled in, and a post with no place of its own gets location null (or its channel business city, marked source: "channel"). At most 255 characters. |
| place | string | Where it was posted, for people ("Shoreditch, London") At most 120 characters. |
| parent_id | string | Parent Post ID if it is a reply or sub-post |
| download_link | string | Download link if applicable At most 255 characters. |
| project_link | string | Project link if applicable At most 255 characters. |
| requires | string | Requirements or prerequisites At most 255 characters. |
| transcript | string | Transcript text if video/audio |
| attribute | string | Post attributes/tags |
| type | string | Post type (e.g., post, article, video). campaign/event/job/fundraiser are reserved. At most 255 characters. |
| group_id | string | Post into a community group (members only; never public) |
| public | boolean | Is this post public? |
| fee | object | Fee amount if applicable |
| topic | string | Topic ID |
| hashtags | string | Hashtags (comma-separated string) At most 255 characters. |
| downloads | object | Downloads count |
| users | string | Users (comma-separated UUIDs) |
| status | string | Post status: draft or published (moderation may hold it) One of: "draft", "published". |
| published | string | Published date/time |
| active_profile_id | string | Profile to post as (must belong to the caller; defaults to the session profile) |
Response
200. The payload in data is not described in the spec yet.
Delete my post
DELETE/posts/{id}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
Fetch comments and replies for a post
GET/posts/{id}/comments
Public: no sign-in needed.
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| active_profile_idrequired | string, query | |
| pagerequired | string, query | |
| limitrequired | string, query |
Response
200. The payload in data is not described in the spec yet.
Add a comment or reply to a post
POST/posts/{id}/comments
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
201. The payload in data is not described in the spec yet.
Dislike or Un-dislike a post
POST/posts/{id}/dislike
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
201. The payload in data is not described in the spec yet.
Make a donation on a post
POST/posts/{id}/donate
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| Idempotency-Key | string, header | Optional client-generated key (8-128 chars, [A-Za-z0-9_-]). A retry with the same key and body replays the first response (Idempotent-Replayed: true); 409 while the first is in flight; 422 if the body differs. |
Request body application/json
| Field | Type | Description |
|---|---|---|
| amountrequired | number | Minimum 1, maximum 10000000. |
| messagerequired | string | At most 255 characters. |
| name | string | At most 255 characters. |
| active_profile_id | string | |
| anonymous | boolean |
Response
201. The payload in data is not described in the spec yet.
Get all donations for a post
GET/posts/{id}/donations
Public: no sign-in needed.
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
Attach a file to a post
POST/posts/{id}/files
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
201. The payload in data is of type object.
Remove a file from a post
DELETE/posts/{id}/files/{file_id}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| file_idrequired | number, path |
Response
200. The payload in data is not described in the spec yet.
Attach multiple files to a post in bulk
POST/posts/{id}/files/bulk
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
201. data is object[].
Like or Unlike a post
POST/posts/{id}/like
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
201. The payload in data is not described in the spec yet.
Profiles who liked a post + total count (drawer)
GET/posts/{id}/likes
Public: no sign-in needed.
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| limitrequired | string, query | |
| offsetrequired | string, query |
Response
200. The payload in data is not described in the spec yet.
Repost, quote-repost, or unrepost a post
POST/posts/{id}/repost
Needs a signed-in user (Bearer token or access_token cookie).
No comment = plain repost/unrepost toggle. A non-empty comment makes it a quote repost (adds/updates the quote text; never toggles off). The quote is trimmed, max 280 characters, and moderated (400 when not approved). Response: { reposted, quoted, comment }.
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
201. The payload in data is of type object.
Profiles who reposted a post + total count (drawer)
GET/posts/{id}/reposts
Public: no sign-in needed.
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| limitrequired | string, query | |
| offsetrequired | string, query |
Response
200. The payload in data is not described in the spec yet.
Save or Unsave a post
POST/posts/{id}/save
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path | |
| active_profile_idrequired | string, query |
Response
201. The payload in data is not described in the spec yet.
Record a post view (deduplicated per viewer)
POST/posts/{id}/view
Public: no sign-in needed.
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
201. The payload in data is not described in the spec yet.
Update my comment
PATCH/posts/comment/{id}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
Delete my comment
DELETE/posts/comment/{id}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
Like or Unlike a comment
POST/posts/comment/{id}/like
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
201. The payload in data is not described in the spec yet.
Fetch all comments written by me
GET/posts/comments/my
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| active_profile_idrequired | string, query |
Response
200. The payload in data is not described in the spec yet.
Get posts feed only from followed profiles
GET/posts/following
Needs a signed-in user (Bearer token or access_token cookie).
Response
200. The payload in data is not described in the spec yet.
Fetch all posts liked by me
GET/posts/likes/my
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| active_profile_idrequired | string, query | |
| includerequired | string, query | |
| pagerequired | string, query | |
| limitrequired | string, query |
Response
200. The payload in data is of type object.
Fetch all my posts
GET/posts/my
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| pagerequired | string, query | |
| limitrequired | string, query |
Response
200. The payload in data is not described in the spec yet.
Fetch a single post of mine
GET/posts/my/{id}
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| idrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
Get a profile's combined feed: its own posts + reposts (with attribution)
GET/posts/profile/{profileId}
Public: no sign-in needed.
Parameters
| Name | Type | Description |
|---|---|---|
| profileIdrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
Fetch all posts reposted by me
GET/posts/reposts/my
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| active_profile_idrequired | string, query |
Response
200. The payload in data is not described in the spec yet.
Fetch all posts saved by me
GET/posts/saves/my
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| active_profile_idrequired | string, query | |
| includerequired | string, query | |
| pagerequired | string, query | |
| limitrequired | string, query |
Response
200. The payload in data is of type object.
Get trending posts feed based on views, comments, and likes
GET/posts/trending
Public: no sign-in needed.
Response
200. The payload in data is not described in the spec yet.