Integrations & SDKs
API
Tags
user and stream tags documentation creator tags creator tags can be managed using the create user and update user endpoints there are two types of tags associated with creators general tags and authorized stream tags general tags general tags are added, edited, and returned with the user object when it is returned in the api this allows you to add information for future use requirements must be an array of objects each tag object must have a "name" field additional fields can be included in each tag object and will be stored and returned example "tags" \[ { "name" "sports commentator", "experience" "5 years", "specialty" "football" }, { "name" "podcast host" } ] authorized stream tags "authorized stream tags" define the tags a user can add to a stream when adding a stream, a user can add tags to the stream from this list, and their selected tags will appear as stream tags requirements must be an array of objects each tag object must have a "name" field optional "tag thumbnail" field can be included to display an image next to the tag name in the user interface any other fields can be added and will be stored and returned when the stream is retrieved example "authorized stream tags" \[ { "name" "nfl", "tag thumbnail" "https //example com/nfl logo png", "league id" "nfl 2023", "season" "2023 2024" }, { "name" "nba", "tag thumbnail" "https //example com/nba logo png" } ] stream tags returned as "tags" in the stream object always includes the "name" field and any additional information associated with the tag these tags are typically derived from the creator's authorized stream tags when the stream is created, and represent what tags a user has selected in their interface from the list of authorized stream tags example "tags" \[ { "name" "nfl", "tag thumbnail" "https //example com/nfl logo png", "league id" "nfl 2023", "season" "2023 2024", "game id" "20231015 sea cin" } ]