Social moderation
12 routes. Paths are relative to https://api.intersink.com/v1. This group belongs to a feature in beta.
- GET/social/channels/{channelId}/groupsThe channel's community groups
- POST/social/channels/{channelId}/groups/{id}/hideHide a group from the channel (reversible)
- POST/social/channels/{channelId}/groups/{id}/restoreShow a hidden group again
- GET/social/channels/{channelId}/overviewCounts: posts, hidden posts, stories, profiles, open reports
- GET/social/channels/{channelId}/postsThe channel's posts, newest first
- POST/social/channels/{channelId}/posts/{id}/hideHide a post from every feed (reversible)
- POST/social/channels/{channelId}/posts/{id}/restoreShow a hidden post again
- GET/social/channels/{channelId}/profilesProfiles on the channel; suspend through Trust & safety
- GET/social/channels/{channelId}/reportsReports people made on the channel
- POST/social/channels/{channelId}/reports/{id}/resolveClose a report as resolved or dismissed
- GET/social/channels/{channelId}/storiesThe channel's live stories
- POST/social/channels/{channelId}/stories/{id}/removeTake a story down
Hide a group from the channel (reversible)
POST/social/channels/{channelId}/groups/{id}/hide
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path | |
| idrequired | string, path |
Request body application/json
| Field | Type | Description |
|---|---|---|
| reason | string | Why; kept in the business audit log At most 500 characters. |
Response
200. The payload in data is not described in the spec yet.
Show a hidden group again
POST/social/channels/{channelId}/groups/{id}/restore
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path | |
| idrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
Counts: posts, hidden posts, stories, profiles, open reports
GET/social/channels/{channelId}/overview
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path |
Response
200. The payload in data is not described in the spec yet.
The channel's posts, newest first
GET/social/channels/{channelId}/posts
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path | |
| page | number, query | Minimum 1. |
| limit | number, query | Minimum 1, maximum 100. |
| state | string, query | One of: "visible", "hidden", "all". |
| q | string, query | At most 120 characters. |
| type | string, query | Only this post type, e.g. listing At most 40 characters. |
Response
200. The payload in data is not described in the spec yet.
Hide a post from every feed (reversible)
POST/social/channels/{channelId}/posts/{id}/hide
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path | |
| idrequired | number, path |
Request body application/json
| Field | Type | Description |
|---|---|---|
| reason | string | Why; kept in the business audit log At most 500 characters. |
Response
200. The payload in data is not described in the spec yet.
Show a hidden post again
POST/social/channels/{channelId}/posts/{id}/restore
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path | |
| idrequired | number, path |
Request body application/json
| Field | Type | Description |
|---|---|---|
| reason | string | Why; kept in the business audit log At most 500 characters. |
Response
200. The payload in data is not described in the spec yet.
Profiles on the channel; suspend through Trust & safety
GET/social/channels/{channelId}/profiles
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path | |
| page | number, query | Minimum 1. |
| limit | number, query | Minimum 1, maximum 100. |
| q | string, query | At most 120 characters. |
Response
200. The payload in data is not described in the spec yet.
Reports people made on the channel
GET/social/channels/{channelId}/reports
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path | |
| page | number, query | Minimum 1. |
| limit | number, query | Minimum 1, maximum 100. |
| state | string, query | One of: "open", "closed". |
Response
200. The payload in data is not described in the spec yet.
Close a report as resolved or dismissed
POST/social/channels/{channelId}/reports/{id}/resolve
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path | |
| idrequired | number, path |
Request body application/json
| Field | Type | Description |
|---|---|---|
| outcome | string | One of: "resolved", "dismissed". |
| note | string | At most 500 characters. |
Response
200. The payload in data is not described in the spec yet.
The channel's live stories
GET/social/channels/{channelId}/stories
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path | |
| page | number, query | Minimum 1. |
| limit | number, query | Minimum 1, maximum 100. |
Response
200. The payload in data is not described in the spec yet.
Take a story down
POST/social/channels/{channelId}/stories/{id}/remove
Needs a signed-in user (Bearer token or access_token cookie).
Parameters
| Name | Type | Description |
|---|---|---|
| channelIdrequired | string, path | |
| idrequired | number, path |
Request body application/json
| Field | Type | Description |
|---|---|---|
| reason | string | Why; kept in the business audit log At most 500 characters. |
Response
200. The payload in data is not described in the spec yet.
The channel's community groups
GET
/social/channels/{channelId}/groupsNeeds a signed-in user (Bearer token or access_token cookie).
Parameters
Response
200. The payload in
datais not described in the spec yet.