Create a new social stream

post

https://api.seismic.com/channel/v1/socials/stream

Create a new social stream with the specified curation settings. For example, an assistant can call this operation while coordinating channel-service workflows to retrieve or change authoritative records before executing dependent user-facing actions. social network permissions, compliance configuration, and membership so that content can be curated and shared from it.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request payload for creating or updating a social stream, including curation settings, network permissions, and compliance configuration.

name

string

required

Display name of the social stream shown to end users in the stream list.

description

string

Free-text description explaining the purpose and audience of this social stream.

streamType

string

enum

required

The curation model of the stream, such as manually curated, auto-curated, RSS feed, or third-party sourced. This value is set at creation time and cannot be changed when updating the stream.

Allowed:

type

string

The classification of the stream within the social module, for example social. This value is set at creation time and cannot be changed when updating the stream.

lang

string

Two-letter ISO 639-1 language code of the content in this stream.

isActive

boolean

Indicates whether the stream is currently active and visible to end users.

socialNetworkPermissions

object

Flags that control which social networks users are allowed to share this stream or content item to from Seismic.

searchFilters

object

Filter criteria applied when automatically curating third-party articles into a social stream.

complianceSettings

object

Compliance review configuration that determines whether and how content in this stream is routed to a compliance system before publishing.

rssFeeds

array of strings

List of RSS feed URLs used as content sources when the stream type is RSSFEED.

rssFeeds

allowCommentsEditable

boolean

Indicates whether end users are allowed to edit the suggested commentary before sharing content.

streamOrder

integer

Position of this stream relative to other streams when displayed in the stream list.

isMandatory

boolean

Indicates whether this stream is mandatory and automatically assigned to all users.

isCustomInterestEnabled

boolean

Indicates whether users can follow this stream through custom interest selections.

interests

array of strings

List of interest tags used to match this stream to user interest preferences.

interests

thumbnailId

string

Identifier of the uploaded thumbnail image displayed for this stream.

thumbnailRelativeUrl

string

Relative URL of the thumbnail image displayed for this stream in the stream list.

iconColor

string

Hexadecimal color code used for the stream icon when no thumbnail image is set.

members

array of strings

List of user or group identifiers granted access to this stream.

members

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

201Created

400Bad Request. Returned when the request payload is invalid, or when the tenant has reached the maximum number of streams (a tenant may have at most 50 streams).

401Unauthorized

500Internal Server Error