Back to Owncast

Owncast APIs (0.2.4)

docs/api/index.html

0.2.5271.4 KB
Original Source
  • External

    • postSend a system message to the chat
    • postSend a system message to a single client
    • postSend a user message to chat
    • postSend a message to chat as a specific 3rd party bot/integration based on its access token
    • optsSendIntegrationChatMessageOptions
    • postSend a user action to chat
    • postHide chat message
    • optsExternalUpdateMessageVisibilityOptions
    • getGet the server's status
    • postStream title
    • optsExternalSetStreamTitleOptions
    • getGet chat history
    • optsExternalGetChatMessagesOptions
    • getConnected clients
    • optsExternalGetConnectedChatClientsOptions
    • getGet a user's details
  • Internal

    • getGet the status of the server
    • getGet list of custom emojis supported in the chat
    • getGets a list of chat messages
    • postRegisters an anonymous chat user
    • postUpdate chat message visibility
    • postEnable/disable a user
    • getGet the web config
    • getGet the YP protocol data
    • getGet all social platforms
    • getGet a list of video variants available
    • getTell the backend you're an active viewer
    • postRequest remote follow
    • getGets the list of followers
    • postSave video playback metrics for future video health recording
    • postRegister for notifications
    • getGet current inboard broadcaster
    • getDisconnect inbound stream
    • getGet the current server config
    • getGet viewer count over time
    • getGet active viewers
    • getGet the current hardware stats
    • getGet a detailed list of currently connected chat clients
    • getGet all chat messages for the admin, unfiltered
    • postUpdate visibility of chat messages
    • postEnable or disable a user
    • getGet a list of disabled users
    • postBan an IP address
    • postRemove an IP ban
    • getGet all banned IP addresses
    • postSet moderator status for a user
    • getGet a list of moderator users
    • optsGetModeratorsOptions
    • getGet all logs
    • optsGetLogsOptions
    • getGet warning/error logs
    • optsGetWarningsOptions
    • getGet followers
    • optsGetFollowersAdminOptions
    • getGet a list of pending follow requests
    • optsGetPendingFollowRequestsOptions
    • getGet a list of rejected or blocked follows
    • optsGetBlockedAndRejectedFollowersOptions
    • postSet the following state of a follower or follow request
    • optsApproveFollowerOptions
    • postUpload custom emoji
    • optsUploadCustomEmojiOptions
    • postDelete custom emoji
    • optsDeleteCustomEmojiOptions
    • postChange the current admin password
    • optsSetAdminPasswordOptions
    • postSet an array of valid stream keys
    • optsSetStreamKeysOptions
    • postChange the extra page content in memory
    • optsSetExtraPageContentOptions
    • postChange the stream title
    • optsSetStreamTitleOptions
    • postChange the server name
    • optsSetServerNameOptions
    • postChange the server summary
    • optsSetServerSummaryOptions
    • postChange the offline message
    • optsSetCustomOfflineMessageOptions
    • postChange the welcome message
    • optsSetServerWelcomeMessageOptions
    • postDisable chat
    • optsSetChatDisabledOptions
    • postEnable chat for user join messages
    • optsSetChatJoinMessagesEnabledOptions
    • postEnable/disable chat established user mode
    • optsSetEnableEstablishedChatUserModeOptions
    • postSet chat usernames that are not allowed
    • optsSetForbiddenUsernameListOptions
    • postSet the suggested chat usernames that will be assigned automatically
    • optsSetSuggestedUsernameListOptions
    • postSet spam protection enabled
    • optsSetChatSpamProtectionEnabledOptions
    • postSet slur filter enabled
    • optsSetChatSlurFilterEnabledOptions
    • postSet require authentication for chat
    • optsSetChatRequireAuthenticationOptions
    • postSet video codec
    • optsSetVideoCodecOptions
    • postSet the number of video segments and duration per segment in a playlist
    • optsSetStreamLatencyLevelOptions
    • postSet an array of video output configurations
    • optsSetStreamOutputVariantsOptions
    • postSet style/color/css values
    • optsSetCustomColorVariableValuesOptions
    • postUpdate logo
    • optsSetLogoOptions
    • postUpload custom favicon
    • delReset favicon to default
    • optsSetFaviconOptions
    • postUpdate server tags
    • optsSetTagsOptions
    • postUpdate FFMPEG path
    • optsSetFfmpegPathOptions
    • postUpdate server port
    • optsSetWebServerPortOptions
    • postUpdate server IP address
    • optsSetWebServerIPOptions
    • postUpdate RTMP post
    • optsSetRTMPServerPortOptions
    • postUpdate websocket host override
    • optsSetSocketHostOverrideOptions
    • postUpdate custom video serving endpoint
    • optsSetVideoServingEndpointOptions
    • postUpdate NSFW marking
    • optsSetNSFWOptions
    • postUpdate directory enabled
    • optsSetDirectoryEnabledOptions
    • postUpdate social handles
    • optsSetSocialHandlesOptions
    • postUpdate S3 configuration
    • optsSetS3ConfigurationOptions
    • postUpdate server url
    • optsSetServerURLOptions
    • postUpdate external action links
    • optsSetExternalActionsOptions
    • postUpdate custom styles
    • optsSetCustomStylesOptions
    • postUpdate custom JavaScript
    • optsSetCustomJavascriptOptions
    • postUpdate hide viewer count
    • optsSetHideViewerCountOptions
    • postUpdate search indexing
    • optsSetDisableSearchIndexingOptions
    • postEnable/disable federation features
    • optsSetFederationEnabledOptions
    • postSet if federation activities are private
    • optsSetFederationActivityPrivateOptions
    • postSet if fediverse engagement appears in chat
    • optsSetFederationShowEngagementOptions
    • postSet local federated username
    • optsSetFederationUsernameOptions
    • postSet federated go live message
    • optsSetFederationGoLiveMessageOptions
    • postSet Federation blocked domains
    • optsSetFederationBlockDomainsOptions
    • postConfigure Discord notifications
    • optsSetDiscordNotificationConfigurationOptions
    • postConfigure Browser notifications
    • optsSetBrowserNotificationConfigurationOptions
    • getGet all the webhooks
    • optsGetWebhooksOptions
    • postDelete a single webhook
    • optsDeleteWebhookOptions
    • postCreate a single webhook
    • optsCreateWebhookOptions
    • getGet all access tokens
    • optsGetExternalAPIUsersOptions
    • postDelete a single external API user
    • optsDeleteExternalAPIUserOptions
    • postCreate a single access token
    • optsCreateExternalAPIUserOptions
    • getReturn the auto-update features that are supported for this instance
    • optsAutoUpdateOptionsOptions
    • getBegin the auto-update
    • optsAutoUpdateStartOptions
    • getForce quit the server and restart it
    • optsAutoUpdateForceQuitOptions
    • getReset YP configuration
    • optsResetYPRegistrationOptions
    • getGet video playback metrics
    • optsGetVideoPlaybackMetricsOptions
    • getEndpoint to interface with Prometheus
    • postEndpoint to interface with Prometheus
    • putEndpoint to interface with Prometheus
    • delEndpoint to interface with Prometheus
    • optsEndpoint to interface with Prometheus
    • postSend a public message to the Fediverse from the server's user
    • optsSendFederatedMessageOptions
    • getGet a paginated list of federated activities
    • optsGetFederatedActionsOptions
    • optsSendSystemMessageOptions
    • optsSendSystemMessageToConnectedClientOptions
    • optsSendUserMessageOptions
    • optsSendChatActionOptions
    • postBegins auth flow
    • getHandle the redirect from an IndieAuth server to continue the auth flow
    • getHandles the IndieAuth auth endpoint
    • postHandles IndieAuth from form submission
    • postRegister a Fediverse OTP request
    • postVerify Fediverse OTP code
  • Auth

    • postBegins auth flow
    • getHandle the redirect from an IndieAuth server to continue the auth flow
    • getHandles the IndieAuth auth endpoint
    • postHandles IndieAuth from form submission
    • postRegister a Fediverse OTP request
    • postVerify Fediverse OTP code
  • Chat

    • getGet list of custom emojis supported in the chat
    • getGets a list of chat messages
    • postRegisters an anonymous chat user
    • optsRegisterAnonymousChatUserOptions
    • postUpdate chat message visibility
    • postEnable/disable a user
    • getGet a detailed list of currently connected chat clients
    • optsGetConnectedChatClientsOptions
    • getGet all chat messages for the admin, unfiltered
    • optsGetChatMessagesAdminOptions
    • postUpdate visibility of chat messages
    • optsUpdateMessageVisibilityAdminOptions
    • postEnable or disable a user
    • optsUpdateUserEnabledAdminOptions
    • getGet a list of disabled users
    • optsGetDisabledUsersOptions
    • postBan an IP address
    • optsBanIPAddressOptions
    • postRemove an IP ban
    • optsUnbanIPAddressOptions
    • getGet all banned IP addresses
    • optsGetIPAddressBansOptions
    • postSet moderator status for a user
    • optsUpdateUserModeratorOptions
    • getGet a list of moderator users
    • postUpload custom emoji
    • optsUploadCustomEmojiOptions
    • postDelete custom emoji
    • optsDeleteCustomEmojiOptions
    • postChange the welcome message
    • optsSetServerWelcomeMessageOptions
    • postDisable chat
    • optsSetChatDisabledOptions
    • postEnable chat for user join messages
    • optsSetChatJoinMessagesEnabledOptions
    • postEnable/disable chat established user mode
    • optsSetEnableEstablishedChatUserModeOptions
    • postSet chat usernames that are not allowed
    • optsSetForbiddenUsernameListOptions
    • postSet the suggested chat usernames that will be assigned automatically
    • optsSetSuggestedUsernameListOptions
    • postSet spam protection enabled
    • optsSetChatSpamProtectionEnabledOptions
    • postSet slur filter enabled
    • optsSetChatSlurFilterEnabledOptions
    • postSet require authentication for chat
    • optsSetChatRequireAuthenticationOptions
    • postUpdate websocket host override
    • optsSetSocketHostOverrideOptions
    • postSend a system message to the chat
    • optsSendSystemMessageOptions
    • postSend a system message to a single client
    • optsSendSystemMessageToConnectedClientOptions
    • postSend a user message to chat
    • optsSendUserMessageOptions
    • postSend a message to chat as a specific 3rd party bot/integration based on its access token
    • optsSendIntegrationChatMessageOptions
    • postSend a user action to chat
    • optsSendChatActionOptions
    • postHide chat message
    • optsExternalUpdateMessageVisibilityOptions
    • getGet chat history
    • optsExternalGetChatMessagesOptions
    • getConnected clients
    • optsExternalGetConnectedChatClientsOptions
    • getGet a user's details
    • getGet a user's details
    • postBegins auth flow
    • getHandle the redirect from an IndieAuth server to continue the auth flow
    • getHandles the IndieAuth auth endpoint
    • postHandles IndieAuth from form submission
    • postRegister a Fediverse OTP request
    • postVerify Fediverse OTP code
  • Objects

    • optsRegisterAnonymousChatUserOptions
    • optsStatusAdminOptions
    • optsDisconnectInboundConnectionOptions
    • optsGetServerConfigOptions
    • optsGetViewersOverTimeOptions
    • optsGetActiveViewersOptions
    • optsGetHardwareStatsOptions
    • optsGetConnectedChatClientsOptions
    • optsGetChatMessagesAdminOptions
    • optsUpdateMessageVisibilityAdminOptions
    • optsUpdateUserEnabledAdminOptions
    • optsGetDisabledUsersOptions
    • optsBanIPAddressOptions
    • optsUnbanIPAddressOptions
    • optsGetIPAddressBansOptions
    • optsUpdateUserModeratorOptions
    • optsGetModeratorsOptions
    • optsGetLogsOptions
    • optsGetWarningsOptions
    • optsGetFollowersAdminOptions
    • optsGetPendingFollowRequestsOptions
    • optsGetBlockedAndRejectedFollowersOptions
    • optsApproveFollowerOptions
    • optsUploadCustomEmojiOptions
    • optsDeleteCustomEmojiOptions
    • optsSetAdminPasswordOptions
    • optsSetStreamKeysOptions
    • optsSetExtraPageContentOptions
    • optsSetStreamTitleOptions
    • postChange the server name
    • optsSetServerNameOptions
    • postChange the server summary
    • optsSetServerSummaryOptions
    • postChange the offline message
    • optsSetCustomOfflineMessageOptions
    • optsSetServerWelcomeMessageOptions
    • optsSetChatDisabledOptions
    • optsSetChatJoinMessagesEnabledOptions
    • optsSetEnableEstablishedChatUserModeOptions
    • optsSetForbiddenUsernameListOptions
    • optsSetSuggestedUsernameListOptions
    • optsSetChatSpamProtectionEnabledOptions
    • optsSetChatSlurFilterEnabledOptions
    • optsSetChatRequireAuthenticationOptions
    • optsSetVideoCodecOptions
    • optsSetStreamLatencyLevelOptions
    • optsSetStreamOutputVariantsOptions
    • optsSetCustomColorVariableValuesOptions
    • optsSetLogoOptions
    • optsSetFaviconOptions
    • optsSetTagsOptions
    • optsSetFfmpegPathOptions
    • optsSetWebServerPortOptions
    • optsSetWebServerIPOptions
    • optsSetRTMPServerPortOptions
    • optsSetSocketHostOverrideOptions
    • optsSetVideoServingEndpointOptions
    • optsSetNSFWOptions
    • optsSetDirectoryEnabledOptions
    • optsSetSocialHandlesOptions
    • optsSetS3ConfigurationOptions
    • optsSetServerURLOptions
    • optsSetExternalActionsOptions
    • optsSetCustomStylesOptions
    • optsSetCustomJavascriptOptions
    • optsSetHideViewerCountOptions
    • optsSetDisableSearchIndexingOptions
    • optsSetFederationEnabledOptions
    • optsSetFederationActivityPrivateOptions
    • optsSetFederationShowEngagementOptions
    • optsSetFederationUsernameOptions
    • optsSetFederationGoLiveMessageOptions
    • optsSetFederationBlockDomainsOptions
    • optsSetDiscordNotificationConfigurationOptions
    • optsSetBrowserNotificationConfigurationOptions
    • optsGetWebhooksOptions
    • optsDeleteWebhookOptions
    • optsCreateWebhookOptions
    • optsGetExternalAPIUsersOptions
    • optsDeleteExternalAPIUserOptions
    • optsCreateExternalAPIUserOptions
    • optsAutoUpdateOptionsOptions
    • optsAutoUpdateStartOptions
    • optsAutoUpdateForceQuitOptions
    • optsResetYPRegistrationOptions
    • optsGetVideoPlaybackMetricsOptions
    • optsSendFederatedMessageOptions
    • optsGetFederatedActionsOptions
    • optsSendSystemMessageOptions
    • optsSendSystemMessageToConnectedClientOptions
    • optsSendUserMessageOptions
    • optsSendIntegrationChatMessageOptions
    • optsSendChatActionOptions
    • optsExternalUpdateMessageVisibilityOptions
    • optsExternalSetStreamTitleOptions
    • optsExternalGetChatMessagesOptions
    • optsExternalGetConnectedChatClientsOptions
  • Video

    • getGet a list of video variants available
    • getTell the backend you're an active viewer
    • getDisconnect inbound stream
    • optsDisconnectInboundConnectionOptions
    • optsGetActiveViewersOptions
    • postSet video codec
    • optsSetVideoCodecOptions
    • postSet the number of video segments and duration per segment in a playlist
    • optsSetStreamLatencyLevelOptions
    • postSet an array of video output configurations
    • optsSetStreamOutputVariantsOptions
    • postUpdate RTMP post
    • optsSetRTMPServerPortOptions
    • postUpdate custom video serving endpoint
    • optsSetVideoServingEndpointOptions
    • postUpdate S3 configuration
    • optsSetS3ConfigurationOptions
    • getGet video playback metrics
    • optsGetVideoPlaybackMetricsOptions
  • Notifications

    • postConfigure Discord notifications
    • optsSetDiscordNotificationConfigurationOptions
    • postConfigure Browser notifications
    • optsSetBrowserNotificationConfigurationOptions
    • getGet all the webhooks
    • optsGetWebhooksOptions
    • postDelete a single webhook
    • optsDeleteWebhookOptions
    • postCreate a single webhook
    • optsCreateWebhookOptions
  • Social

    • postRequest remote follow
    • getGets the list of followers
    • getGet followers
    • getGet a list of pending follow requests
    • optsGetPendingFollowRequestsOptions
    • getGet a list of rejected or blocked follows
    • optsGetBlockedAndRejectedFollowersOptions
    • postSet the following state of a follower or follow request
    • optsApproveFollowerOptions
    • postEnable/disable federation features
    • optsSetFederationEnabledOptions
    • postSet if federation activities are private
    • optsSetFederationActivityPrivateOptions
    • postSet if fediverse engagement appears in chat
    • optsSetFederationShowEngagementOptions
    • postSet local federated username
    • optsSetFederationUsernameOptions
    • postSet federated go live message
    • optsSetFederationGoLiveMessageOptions
    • postSet Federation blocked domains
    • optsSetFederationBlockDomainsOptions
    • postSend a public message to the Fediverse from the server's user
    • optsSendFederatedMessageOptions
    • getGet a paginated list of federated activities
    • optsGetFederatedActionsOptions
  • Admin

    • getGet current inboard broadcaster
    • getDisconnect inbound stream
    • getGet the current server config
    • getGet viewer count over time
    • getGet active viewers
    • getGet the current hardware stats
    • getGet a detailed list of currently connected chat clients
    • getGet all chat messages for the admin, unfiltered
    • postUpdate visibility of chat messages
    • postEnable or disable a user
    • getGet a list of disabled users
    • postBan an IP address
    • postRemove an IP ban
    • getGet all banned IP addresses
    • postSet moderator status for a user
    • getGet a list of moderator users
    • optsGetModeratorsOptions
    • getGet all logs
    • optsGetLogsOptions
    • getGet warning/error logs
    • optsGetWarningsOptions
    • getGet followers
    • optsGetFollowersAdminOptions
    • getGet a list of pending follow requests
    • optsGetPendingFollowRequestsOptions
    • getGet a list of rejected or blocked follows
    • optsGetBlockedAndRejectedFollowersOptions
    • postSet the following state of a follower or follow request
    • optsApproveFollowerOptions
    • postUpload custom emoji
    • optsUploadCustomEmojiOptions
    • postDelete custom emoji
    • optsDeleteCustomEmojiOptions
    • postChange the current admin password
    • optsSetAdminPasswordOptions
    • postSet an array of valid stream keys
    • optsSetStreamKeysOptions
    • postChange the extra page content in memory
    • optsSetExtraPageContentOptions
    • postChange the stream title
    • optsSetStreamTitleOptions
    • postChange the server name
    • optsSetServerNameOptions
    • postChange the server summary
    • optsSetServerSummaryOptions
    • postChange the offline message
    • optsSetCustomOfflineMessageOptions
    • postChange the welcome message
    • optsSetServerWelcomeMessageOptions
    • postDisable chat
    • optsSetChatDisabledOptions
    • postEnable chat for user join messages
    • optsSetChatJoinMessagesEnabledOptions
    • postEnable/disable chat established user mode
    • optsSetEnableEstablishedChatUserModeOptions
    • postSet chat usernames that are not allowed
    • optsSetForbiddenUsernameListOptions
    • postSet the suggested chat usernames that will be assigned automatically
    • optsSetSuggestedUsernameListOptions
    • postSet spam protection enabled
    • optsSetChatSpamProtectionEnabledOptions
    • postSet slur filter enabled
    • optsSetChatSlurFilterEnabledOptions
    • postSet require authentication for chat
    • optsSetChatRequireAuthenticationOptions
    • postSet video codec
    • optsSetVideoCodecOptions
    • postSet the number of video segments and duration per segment in a playlist
    • optsSetStreamLatencyLevelOptions
    • postSet an array of video output configurations
    • optsSetStreamOutputVariantsOptions
    • postSet style/color/css values
    • optsSetCustomColorVariableValuesOptions
    • postUpdate logo
    • optsSetLogoOptions
    • postUpload custom favicon
    • delReset favicon to default
    • optsSetFaviconOptions
    • postUpdate server tags
    • optsSetTagsOptions
    • postUpdate FFMPEG path
    • optsSetFfmpegPathOptions
    • postUpdate server port
    • optsSetWebServerPortOptions
    • postUpdate server IP address
    • optsSetWebServerIPOptions
    • postUpdate RTMP post
    • optsSetRTMPServerPortOptions
    • postUpdate websocket host override
    • optsSetSocketHostOverrideOptions
    • postUpdate custom video serving endpoint
    • optsSetVideoServingEndpointOptions
    • postUpdate NSFW marking
    • optsSetNSFWOptions
    • postUpdate directory enabled
    • optsSetDirectoryEnabledOptions
    • postUpdate social handles
    • optsSetSocialHandlesOptions
    • postUpdate S3 configuration
    • optsSetS3ConfigurationOptions
    • postUpdate server url
    • optsSetServerURLOptions
    • postUpdate external action links
    • optsSetExternalActionsOptions
    • postUpdate custom styles
    • optsSetCustomStylesOptions
    • postUpdate custom JavaScript
    • optsSetCustomJavascriptOptions
    • postUpdate hide viewer count
    • optsSetHideViewerCountOptions
    • postUpdate search indexing
    • optsSetDisableSearchIndexingOptions
    • postEnable/disable federation features
    • optsSetFederationEnabledOptions
    • postSet if federation activities are private
    • optsSetFederationActivityPrivateOptions
    • postSet if fediverse engagement appears in chat
    • optsSetFederationShowEngagementOptions
    • postSet local federated username
    • optsSetFederationUsernameOptions
    • postSet federated go live message
    • optsSetFederationGoLiveMessageOptions
    • postSet Federation blocked domains
    • optsSetFederationBlockDomainsOptions
    • postConfigure Discord notifications
    • optsSetDiscordNotificationConfigurationOptions
    • postConfigure Browser notifications
    • optsSetBrowserNotificationConfigurationOptions
    • getGet all the webhooks
    • optsGetWebhooksOptions
    • postDelete a single webhook
    • optsDeleteWebhookOptions
    • postCreate a single webhook
    • optsCreateWebhookOptions
    • getGet all access tokens
    • optsGetExternalAPIUsersOptions
    • postDelete a single external API user
    • optsDeleteExternalAPIUserOptions
    • postCreate a single access token
    • optsCreateExternalAPIUserOptions
    • getReturn the auto-update features that are supported for this instance
    • optsAutoUpdateOptionsOptions
    • getBegin the auto-update
    • optsAutoUpdateStartOptions
    • getForce quit the server and restart it
    • optsAutoUpdateForceQuitOptions
    • getReset YP configuration
    • optsResetYPRegistrationOptions
    • getGet video playback metrics
    • optsGetVideoPlaybackMetricsOptions
    • getEndpoint to interface with Prometheus
    • postEndpoint to interface with Prometheus
    • putEndpoint to interface with Prometheus
    • delEndpoint to interface with Prometheus
    • optsEndpoint to interface with Prometheus
    • postSend a public message to the Fediverse from the server's user
    • optsSendFederatedMessageOptions
    • getGet a paginated list of federated activities
    • optsGetFederatedActionsOptions
    • optsSendSystemMessageOptions
    • optsSendSystemMessageToConnectedClientOptions
    • optsSendUserMessageOptions
    • optsSendIntegrationChatMessageOptions
    • optsSendChatActionOptions
    • optsExternalUpdateMessageVisibilityOptions
    • optsExternalSetStreamTitleOptions
    • optsExternalGetChatMessagesOptions
    • optsExternalGetConnectedChatClientsOptions

API docs by Redocly

Owncast APIs (0.2.4)

Download OpenAPI specification:

Gabe Kangas: [email protected] URL: http://owncast.online License: MIT

Internal The APIs required to make the Owncast web interface and internal functionality work. These APIs will never reach stability and will always change as Owncast features and functionality change. This means these endpoints are not good options to build your own tooling and features on top of. You can, however, of course can if that risk is acceptable to you.

Admin The APIs used to configure the Owncast server, as well as power the web admin interface. These APIs are protected by the admin password, using HTTP Basic authentication. They should not be used by external tools or integrations as it would require you to give your admin password to a third party.

External

These APIs are specifically exposed for building third party applications or tooling. They use auth tokens to authenticate and are designed to be stable and reliable.

Send a system message to the chat

Authorizations:

BearerAuth

Request Body schema: application/json

The content of the system message

| body |

string

|

Responses

200

Message sent successfully

400

Bad request

401

Unauthorized

500

Internal Server Error

default

Unexpected error

post/integrations/chat/system

Localhost port 8080

http://localhost:8080/api/integrations/chat/system

Request samples

  • Payload

Content type application/json

Copy

`{ "body": "string"

}`

Response samples

  • 200
  • 400
  • 500
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Send a system message to a single client

Authorizations:

BearerAuth

path Parameters

| clientId required |

integer

The ID of the specified client

|

Request Body schema: application/json

| timestamp |

string

| | type |

string

| | id |

string

| | body |

string

|

Responses

400

Bad request

401

Unauthorized

500

Internal Server Error

default

Unexpected error

post/integrations/chat/system/client/{clientId}

Localhost port 8080

http://localhost:8080/api/integrations/chat/system/client/{clientId}

Request samples

  • Payload

Content type application/json

Copy

`{

"timestamp": "string",

"type": "string",

"id": "string",

"body": "string"

}`

Response samples

  • 400
  • 500
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Send a user message to chat Deprecated

Authorizations:

BearerAuth

Responses

400

Bad request

post/integrations/chat/user

Localhost port 8080

http://localhost:8080/api/integrations/chat/user

Response samples

  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Send a message to chat as a specific 3rd party bot/integration based on its access token

Authorizations:

BearerAuth

Request Body schema: application/json

| body |

string

|

Responses

200

Message sent successfully

400

Bad request

401

Unauthorized

500

Internal Server Error

default

Unexpected error

post/integrations/chat/send

Localhost port 8080

http://localhost:8080/api/integrations/chat/send

Request samples

  • Payload

Content type application/json

Copy

`{ "body": "string"

}`

Response samples

  • 200
  • 400
  • 500
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SendIntegrationChatMessageOptions

Responses

204

No Content

options/integrations/chat/send

Localhost port 8080

http://localhost:8080/api/integrations/chat/send

Send a user action to chat

Authorizations:

BearerAuth

Request Body schema: application/json

| body |

string

|

Responses

200

Action sent successfully

400

Bad request

401

Unauthorized

500

Internal Server Error

default

Unexpected error

post/integrations/chat/action

Localhost port 8080

http://localhost:8080/api/integrations/chat/action

Request samples

  • Payload

Content type application/json

Copy

`{ "body": "string"

}`

Response samples

  • 200
  • 400
  • 500
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Hide chat message

Authorizations:

BearerAuth

Request Body schema: application/json

| idArray |

Array of strings

| | visible |

boolean

|

Responses

200

Messages updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/integrations/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/integrations/chat/messagevisibility

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"idArray": ["string" ],

"visible": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

ExternalUpdateMessageVisibilityOptions

Responses

204

No Content

options/integrations/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/integrations/chat/messagevisibility

Get the server's status

Authorizations:

BearerAuth

Responses

200

Status

401

Basic auth failure

404

Not found

default

Unexpected error

get/integrations/status

Localhost port 8080

http://localhost:8080/api/integrations/status

Response samples

  • 200
  • default

Content type application/json

Copy

`{

"serverTime": "string",

"lastConnectTime": "string",

"lastDisconnectTime": "string",

"versionNumber": "string",

"viewerCount": 0,

"online": true,

"streamTitle": "string"

}`

Stream title

Authorizations:

BearerAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Stream title has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/integrations/streamtitle

Localhost port 8080

http://localhost:8080/api/integrations/streamtitle

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

ExternalSetStreamTitleOptions

Responses

204

No Content

options/integrations/streamtitle

Localhost port 8080

http://localhost:8080/api/integrations/streamtitle

Get chat history

Authorizations:

BearerAuth

Responses

200

List of chat messages

401

Unauthorized

501

Not Implemented

default

Unexpected error

get/integrations/chat

Localhost port 8080

http://localhost:8080/api/integrations/chat

Response samples

  • 200
  • 501
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"timestamp": "string",

"type": "string",

"id": "string",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"hiddenAt": "string",

"clientId": 0,

"body": "string"

}

]`

ExternalGetChatMessagesOptions

Responses

204

No Content

options/integrations/chat

Localhost port 8080

http://localhost:8080/api/integrations/chat

Connected clients

Authorizations:

BearerAuth

Responses

200

List of chat clients

400

Bad request

401

Basic auth failure

default

Unexpected error

get/integrations/clients

Localhost port 8080

http://localhost:8080/api/integrations/clients

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"connectedAt": "2019-08-24T14:15:22Z",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"geo": {

"countryCode": "string",

"regionName": "string",

"timeZone": "string"

},

"userAgent": "string",

"messageCount": 0

}

]`

ExternalGetConnectedChatClientsOptions

Responses

204

No Content

options/integrations/clients

Localhost port 8080

http://localhost:8080/api/integrations/clients

Get a user's details

Authorizations:

BearerAuth

path Parameters

| userId required |

string

The ID of the user to find

|

Responses

200

User information

401

Basic auth failure

404

Not found

default

Unexpected error

get/integrations/moderation/chat/user/{userId}

Localhost port 8080

http://localhost:8080/api/integrations/moderation/chat/user/{userId}

Response samples

  • 200
  • default

Content type application/json

Copy Expand all Collapse all

`{

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"connectedClients": [ {

"connectedAt": "2019-08-24T14:15:22Z",

"userAgent": "string",

"geo": "string",

"id": 0,

"messageCount": 0

}

],

"messages": [ {

"timestamp": "string",

"type": "string",

"id": "string",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"hiddenAt": "string",

"clientId": 0,

"body": "string"

}

]

}`

Internal

These APIs are used internally for the operation of the application. They should not be used by third party clients or tooling, as they may require sharing your admin password, and additionally may change at any time.

Get the status of the server

Responses

200

Successful response

get/status

Localhost port 8080

http://localhost:8080/api/status

Response samples

  • 200

Content type application/json

Copy

`{

"serverTime": "string",

"lastConnectTime": "string",

"lastDisconnectTime": "string",

"versionNumber": "string",

"viewerCount": 0,

"online": true,

"streamTitle": "string"

}`

Get list of custom emojis supported in the chat

Responses

200

List of valid emojis

500

Internal Server Error

get/emoji

Localhost port 8080

http://localhost:8080/api/emoji

Response samples

  • 200
  • 500

Content type application/json

Copy Expand all Collapse all

`[ {

"name": "string",

"url": "string"

}

]`

Gets a list of chat messages

query Parameters

| accessToken required |

string

|

Responses

200

List of chat messages

401

Unauthorized

501

Not Implemented

get/chat

Localhost port 8080

http://localhost:8080/api/chat

Response samples

  • 200
  • 501

Content type application/json

Copy Expand all Collapse all

`[ {

"timestamp": "string",

"type": "string",

"id": "string",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"hiddenAt": "string",

"clientId": 0,

"body": "string"

}

]`

Registers an anonymous chat user

header Parameters

| X-Forwarded-User |

string

|

Request Body schema: application/json optional

The display name of the new user

| displayName |

string

|

Responses

200

Anonymous user information

400

Bad request

post/chat/register

Localhost port 8080

http://localhost:8080/api/chat/register

Request samples

  • Payload

Content type application/json

Copy

`{ "displayName": "string"

}`

Response samples

  • 200
  • 400

Content type application/json

Copy

`{

"id": "string",

"accessToken": "string",

"displayName": "string"

}`

Update chat message visibility

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

| idArray |

Array of strings

| | visible |

boolean

|

Responses

200

Message visibility updated

400

Bad request

401

Unauthorized

default

Unexpected error

post/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/chat/messagevisibility

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"idArray": ["string" ],

"visible": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Enable/disable a user

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

| userId |

string

| | enabled |

boolean

|

Responses

200

User status has been updated

400

Bad request

401

Unauthorized

default

Unexpected error

post/chat/users/setenabled

Localhost port 8080

http://localhost:8080/api/chat/users/setenabled

Request samples

  • Payload

Content type application/json

Copy

`{

"userId": "string",

"enabled": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get the web config

Responses

200

The current web config

500

Internal Server Error

get/config

Localhost port 8080

http://localhost:8080/api/config

Response samples

  • 200
  • 500

Content type application/json

Copy Expand all Collapse all

`{

"appearanceVariables": {

"property1": "string",

"property2": "string"

},

"name": "string",

"customStyles": "string",

"streamTitle": "string",

"offlineMessage": "string",

"logo": "string",

"version": "string",

"socketHostOverride": "string",

"extraPageContent": "string",

"summary": "string",

"tags": ["string" ],

"socialHandles": [ {

"platform": "string",

"url": "string",

"icon": "string"

}

],

"externalActions": [ {

"url": "string",

"html": "string",

"title": "string",

"description": "string",

"icon": "string",

"color": "string",

"openExternally": true

}

],

"notifications": { "browser": {

"publicKey": "string",

"enabled": true

}

},

"federation": {

"account": "string",

"followerCount": 0,

"enabled": true

},

"maxSocketPayloadSize": 0,

"hideViewerCount": true,

"chatDisabled": true,

"chatRequireAuthentication": true,

"nsfw": true,

"authentication": { "indieAuthEnabled": true

}

}`

Get the YP protocol data

Responses

200

The current YP protocol configuration

404

Not found

get/yp

Localhost port 8080

http://localhost:8080/api/yp

Response samples

  • 200

Content type application/json

Copy Expand all Collapse all

`{

"lastConnectTime": "string",

"name": "string",

"description": "string",

"streamTitle": "string",

"logo": "string",

"tags": ["string" ],

"social": [ {

"platform": "string",

"url": "string",

"icon": "string"

}

],

"viewerCount": 0,

"overallMaxViewerCount": 0,

"sessionMaxViewerCount": 0,

"nsfw": true,

"online": true

}`

Get all social platforms

Responses

200

The list of social platforms

500

Internal Server Error

get/socialplatforms

Localhost port 8080

http://localhost:8080/api/socialplatforms

Response samples

  • 200
  • 500

Content type application/json

Copy Expand all Collapse all

`{

"property1": {

"platform": "string",

"url": "string",

"icon": "string"

},

"property2": {

"platform": "string",

"url": "string",

"icon": "string"

}

}`

Get a list of video variants available

Responses

200

List of available video variants

get/video/variants

Localhost port 8080

http://localhost:8080/api/video/variants

Response samples

  • 200

Content type application/json

Copy Expand all Collapse all

`[ {

"index": 0,

"name": "string"

}

]`

Tell the backend you're an active viewer

Responses

200

Added as an active viewer

get/ping

Localhost port 8080

http://localhost:8080/api/ping

Request remote follow

Request Body schema: application/json

| account |

string

|

Responses

200

Contains redirect URL remote follow follow

400

Bad request

post/remotefollow

Localhost port 8080

http://localhost:8080/api/remotefollow

Request samples

  • Payload

Content type application/json

Copy

`{ "account": "string"

}`

Response samples

  • 200
  • 400

Content type application/json

Copy

`{ "redirectUrl": "string"

}`

Gets the list of followers

query Parameters

| offset |

integer

The number of items to skip before starting to collect the result set

| | limit |

integer

The numbers of items to return

|

Responses

200

Paginated follower count

400

Bad request

get/followers

Localhost port 8080

http://localhost:8080/api/followers

Response samples

  • 200
  • 400

Content type application/json

Copy Expand all Collapse all

`{

"total": 0,

"results": [ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]

}`

Save video playback metrics for future video health recording

Request Body schema: application/json

Video metrics to record

| bandwidth |

number <double>

| | latency |

number <double>

| | errors |

number <double>

| | downloadDuration |

number <double>

| | qualityVariantChanges |

number <double>

|

Responses

200

Metrics successfully recorded

400

Bad request

post/metrics/playback

Localhost port 8080

http://localhost:8080/api/metrics/playback

Request samples

  • Payload

Content type application/json

Copy

`{

"bandwidth": 0.1,

"latency": 0.1,

"errors": 0.1,

"downloadDuration": 0.1,

"qualityVariantChanges": 0.1

}`

Response samples

  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Register for notifications

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

Information for notification

| channel |

string

Name of notification channel

| | destination |

string

Target of the notification in the channel

|

Responses

200

Successfully added notification channel

400

Bad request

401

Unauthorized

post/notifications/register

Localhost port 8080

http://localhost:8080/api/notifications/register

Request samples

  • Payload

Content type application/json

Copy

`{

"channel": "string",

"destination": "string"

}`

Response samples

  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get current inboard broadcaster

Authorizations:

BasicAuth

Responses

200

Gives the status of the system

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/status

Localhost port 8080

http://localhost:8080/api/admin/status

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"broadcaster": {

"time": "2019-08-24T14:15:22Z",

"remoteAddr": "string",

"streamDetails": {

"videoCodec": "string",

"audioCodec": "string",

"encoder": "string",

"width": 0,

"height": 0,

"videoBitrate": 0,

"audioBitrate": 0,

"framerate": 0.1

}

},

"currentBroadcast": {

"outputSettings": [ {

"name": "string",

"videoPassthrough": true,

"audioPassthrough": true,

"videoBitrate": 0,

"audioBitrate": 0,

"scaledWidth": 0,

"scaledHeight": 0,

"framerate": 0,

"cpuUsageLevel": 0

}

],

"latencyLevel": { "level": 0

}

},

"health": {

"message": "string",

"healthPercentage": 0,

"representation": 0,

"healthy": true

},

"streamTitle": "string",

"versionNumber": "string",

"viewerCount": 0,

"overallPeakViewerCount": 0,

"sessionPeakViewerCount": 0,

"online": true

}`

Disconnect inbound stream

Authorizations:

BasicAuth

Responses

200

Contains information about disconnection status

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/disconnect

Localhost port 8080

http://localhost:8080/api/admin/disconnect

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get the current server config

Authorizations:

BasicAuth

Responses

200

Current server config

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/serverconfig

Localhost port 8080

http://localhost:8080/api/admin/serverconfig

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"instanceDetails": {

"appearanceVariables": {

"property1": "string",

"property2": "string"

},

"version": "string",

"welcomeMessage": "string",

"offlineMessage": "string",

"logo": "string",

"name": "string",

"extraPageContent": "string",

"streamTitle": "string",

"customStyles": "string",

"customJavascript": "string",

"summary": "string",

"tags": ["string" ],

"socialHandles": [ {

"platform": "string",

"url": "string",

"icon": "string"

}

],

"nsfw": true

},

"notifications": {

"browser": {

"goLiveMessage": "string",

"enabled": true

},

"discord": {

"webhook": "string",

"goLiveMessage": "string",

"enabled": true

}

},

"yp": {

"instanceUrl": "string",

"enabled": true

},

"ffmpegPath": "string",

"adminPassword": "string",

"socketHostOverride": "string",

"webServerIP": "string",

"videoCodec": "string",

"videoServingEndpoint": "string",

"s3": {

"endpoint": "string",

"accessKey": "string",

"secret": "string",

"bucket": "string",

"region": "string",

"acl": "string",

"pathPrefix": "string",

"enabled": true,

"forcePathStyle": true

},

"federation": {

"username": "string",

"goLiveMessage": "string",

"blockedDomains": ["string" ],

"enabled": true,

"isPrivate": true,

"showEngagement": true

},

"supportedCodecs": ["string" ],

"externalActions": [ {

"url": "string",

"html": "string",

"title": "string",

"description": "string",

"icon": "string",

"color": "string",

"openExternally": true

}

],

"forbiddenUsernames": ["string" ],

"suggestedUsernames": ["string" ],

"streamKeys": [ {

"key": "string",

"comment": "string"

}

],

"videoSettings": {

"videoQualityVariants": [ {

"name": "string",

"videoPassthrough": true,

"audioPassthrough": true,

"videoBitrate": 0,

"audioBitrate": 0,

"scaledWidth": 0,

"scaledHeight": 0,

"framerate": 0,

"cpuUsageLevel": 0

}

],

"latencyLevel": 0

},

"rtmpServerPort": 0,

"webServerPort": 0,

"chatDisabled": true,

"chatJoinMessagesEnabled": true,

"chatEstablishedUserMode": true,

"disableSearchIndexing": true,

"streamKeyOverridden": true,

"hideViewerCount": true

}`

Get viewer count over time

Authorizations:

BasicAuth

query Parameters

| windowStart |

string

Start date in unix time

|

Responses

200

Viewer count over time

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/viewersOverTime

Localhost port 8080

http://localhost:8080/api/admin/viewersOverTime

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

]`

Get active viewers

Authorizations:

BasicAuth

Responses

200

List of active viewers

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/viewers

Localhost port 8080

http://localhost:8080/api/admin/viewers

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"firstSeen": "2019-08-24T14:15:22Z",

"geo": {

"countryCode": "string",

"regionName": "string",

"timeZone": "string"

},

"userAgent": "string",

"ipAddress": "string",

"clientID": "string"

}

]`

Get the current hardware stats

Authorizations:

BasicAuth

Responses

200

Current hardware stats

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/hardwarestats

Localhost port 8080

http://localhost:8080/api/admin/hardwarestats

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"message": "string",

"healthPercentage": 0,

"representation": 0,

"healthy": true,

"disk": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"memory": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"cpu": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

]

}`

Get a detailed list of currently connected chat clients

Authorizations:

BasicAuth

Responses

200

List of chat clients

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/clients

Localhost port 8080

http://localhost:8080/api/admin/chat/clients

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"connectedAt": "2019-08-24T14:15:22Z",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"geo": {

"countryCode": "string",

"regionName": "string",

"timeZone": "string"

},

"userAgent": "string",

"messageCount": 0

}

]`

Get all chat messages for the admin, unfiltered

Authorizations:

BasicAuth

Responses

200

List of chat messages for the admin

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/messages

Localhost port 8080

http://localhost:8080/api/admin/chat/messages

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"timestamp": "string",

"type": "string",

"id": "string",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"hiddenAt": "string",

"clientId": 0,

"body": "string"

}

]`

Update visibility of chat messages

Authorizations:

BasicAuth

Request Body schema: application/json

| idArray |

Array of strings

| | visible |

boolean

|

Responses

200

Messages updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/admin/chat/messagevisibility

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"idArray": ["string" ],

"visible": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Enable or disable a user

Authorizations:

BasicAuth

Request Body schema: application/json

| userId |

string

| | enabled |

boolean

|

Responses

200

Successfully updated the user

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/setenabled

Localhost port 8080

http://localhost:8080/api/admin/chat/users/setenabled

Request samples

  • Payload

Content type application/json

Copy

`{

"userId": "string",

"enabled": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get a list of disabled users

Authorizations:

BasicAuth

Responses

200

List of disabled users

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/users/disabled

Localhost port 8080

http://localhost:8080/api/admin/chat/users/disabled

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

}

]`

Ban an IP address

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

IP was successfully banned

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/ipbans/create

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans/create

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Remove an IP ban

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

string or boolean or Array of strings or number

|

Responses

200

IP ban was successfully removed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/ipbans/remove

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans/remove

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get all banned IP addresses

Authorizations:

BasicAuth

Responses

200

List of banned IP addresses

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/users/ipbans

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "2019-08-24T14:15:22Z",

"ipAddress": "string",

"notes": "string"

}

]`

Set moderator status for a user

Authorizations:

BasicAuth

Request Body schema: application/json

| userId |

string

| | isModerator |

boolean

|

Responses

200

Successfully update the moderator status of the user

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/setmoderator

Localhost port 8080

http://localhost:8080/api/admin/chat/users/setmoderator

Request samples

  • Payload

Content type application/json

Copy

`{

"userId": "string",

"isModerator": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get a list of moderator users

Authorizations:

BasicAuth

Responses

200

List of moderator users

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/users/moderators

Localhost port 8080

http://localhost:8080/api/admin/chat/users/moderators

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

}

]`

GetModeratorsOptions

Responses

204

No Content

options/admin/chat/users/moderators

Localhost port 8080

http://localhost:8080/api/admin/chat/users/moderators

Get all logs

Authorizations:

BasicAuth

Responses

200

List of logs

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/logs

Localhost port 8080

http://localhost:8080/api/admin/logs

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"time": "2019-08-24T14:15:22Z",

"message": "string",

"level": "string"

}

]`

GetLogsOptions

Responses

204

No Content

options/admin/logs

Localhost port 8080

http://localhost:8080/api/admin/logs

Get warning/error logs

Authorizations:

BasicAuth

Responses

200

List of warnings and errors

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/logs/warnings

Localhost port 8080

http://localhost:8080/api/admin/logs/warnings

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"time": "2019-08-24T14:15:22Z",

"message": "string",

"level": "string"

}

]`

GetWarningsOptions

Responses

204

No Content

options/admin/logs/warnings

Localhost port 8080

http://localhost:8080/api/admin/logs/warnings

Get followers

Authorizations:

BasicAuth

query Parameters

| offset |

integer

The number of items to skip before starting to collect the result set

| | limit |

integer

The numbers of items to return

|

Responses

200

Paginated follower count

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/followers

Localhost port 8080

http://localhost:8080/api/admin/followers

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"total": 0,

"results": [ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]

}`

GetFollowersAdminOptions

Responses

204

No Content

options/admin/followers

Localhost port 8080

http://localhost:8080/api/admin/followers

Get a list of pending follow requests

Authorizations:

BasicAuth

Responses

200

List of pending followers

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/followers/pending

Localhost port 8080

http://localhost:8080/api/admin/followers/pending

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]`

GetPendingFollowRequestsOptions

Responses

204

No Content

options/admin/followers/pending

Localhost port 8080

http://localhost:8080/api/admin/followers/pending

Get a list of rejected or blocked follows

Authorizations:

BasicAuth

Responses

200

List of rejected or blocked follows

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/followers/blocked

Localhost port 8080

http://localhost:8080/api/admin/followers/blocked

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]`

GetBlockedAndRejectedFollowersOptions

Responses

204

No Content

options/admin/followers/blocked

Localhost port 8080

http://localhost:8080/api/admin/followers/blocked

Set the following state of a follower or follow request

Authorizations:

BasicAuth

Request Body schema: application/json

| actorIRI |

string

| | approved |

boolean

|

Responses

200

List of rejected or blocked follows

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/followers/approve

Localhost port 8080

http://localhost:8080/api/admin/followers/approve

Request samples

  • Payload

Content type application/json

Copy

`{

"actorIRI": "string",

"approved": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

ApproveFollowerOptions

Responses

204

No Content

options/admin/followers/approve

Localhost port 8080

http://localhost:8080/api/admin/followers/approve

Upload custom emoji

Authorizations:

BasicAuth

Request Body schema: application/json

| name |

string

| | data |

string

Base 64 encoded image data

|

Responses

200

Emoji has been uploaded

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/emoji/upload

Localhost port 8080

http://localhost:8080/api/admin/emoji/upload

Request samples

  • Payload

Content type application/json

Copy

`{

"name": "string",

"data": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

UploadCustomEmojiOptions

Responses

204

No Content

options/admin/emoji/upload

Localhost port 8080

http://localhost:8080/api/admin/emoji/upload

Delete custom emoji

Authorizations:

BasicAuth

Request Body schema: application/json

| name |

string

|

Responses

200

Emoji has been deleted

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/emoji/delete

Localhost port 8080

http://localhost:8080/api/admin/emoji/delete

Request samples

  • Payload

Content type application/json

Copy

`{ "name": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

DeleteCustomEmojiOptions

Responses

204

No Content

options/admin/emoji/delete

Localhost port 8080

http://localhost:8080/api/admin/emoji/delete

Change the current admin password

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Admin password has been updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/adminpass

Localhost port 8080

http://localhost:8080/api/admin/config/adminpass

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetAdminPasswordOptions

Responses

204

No Content

options/admin/config/adminpass

Localhost port 8080

http://localhost:8080/api/admin/config/adminpass

Set an array of valid stream keys

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of objects (StreamKey)

|

Responses

200

Stream keys have been updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/streamkeys

Localhost port 8080

http://localhost:8080/api/admin/config/streamkeys

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": [ {

"key": "string",

"comment": "string"

}

]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetStreamKeysOptions

Responses

204

No Content

options/admin/config/streamkeys

Localhost port 8080

http://localhost:8080/api/admin/config/streamkeys

Change the extra page content in memory

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Page content has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/pagecontent

Localhost port 8080

http://localhost:8080/api/admin/config/pagecontent

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetExtraPageContentOptions

Responses

204

No Content

options/admin/config/pagecontent

Localhost port 8080

http://localhost:8080/api/admin/config/pagecontent

Change the stream title

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Stream title has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/streamtitle

Localhost port 8080

http://localhost:8080/api/admin/config/streamtitle

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetStreamTitleOptions

Responses

204

No Content

options/admin/config/streamtitle

Localhost port 8080

http://localhost:8080/api/admin/config/streamtitle

Change the server name

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Server name has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/name

Localhost port 8080

http://localhost:8080/api/admin/config/name

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerNameOptions

Responses

204

No Content

options/admin/config/name

Localhost port 8080

http://localhost:8080/api/admin/config/name

Change the server summary

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Server summary has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/serversummary

Localhost port 8080

http://localhost:8080/api/admin/config/serversummary

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerSummaryOptions

Responses

204

No Content

options/admin/config/serversummary

Localhost port 8080

http://localhost:8080/api/admin/config/serversummary

Change the offline message

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Offline message has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/offlinemessage

Localhost port 8080

http://localhost:8080/api/admin/config/offlinemessage

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetCustomOfflineMessageOptions

Responses

204

No Content

options/admin/config/offlinemessage

Localhost port 8080

http://localhost:8080/api/admin/config/offlinemessage

Change the welcome message

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Welcome message has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/welcomemessage

Localhost port 8080

http://localhost:8080/api/admin/config/welcomemessage

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerWelcomeMessageOptions

Responses

204

No Content

options/admin/config/welcomemessage

Localhost port 8080

http://localhost:8080/api/admin/config/welcomemessage

Disable chat

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Chat has been disabled

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/disable

Localhost port 8080

http://localhost:8080/api/admin/config/chat/disable

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatDisabledOptions

Responses

204

No Content

options/admin/config/chat/disable

Localhost port 8080

http://localhost:8080/api/admin/config/chat/disable

Enable chat for user join messages

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

User join messages has been enabled

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/joinmessagesenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/joinmessagesenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatJoinMessagesEnabledOptions

Responses

204

No Content

options/admin/config/chat/joinmessagesenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/joinmessagesenabled

Enable/disable chat established user mode

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Chat established user mode updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/establishedusermode

Localhost port 8080

http://localhost:8080/api/admin/config/chat/establishedusermode

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetEnableEstablishedChatUserModeOptions

Responses

204

No Content

options/admin/config/chat/establishedusermode

Localhost port 8080

http://localhost:8080/api/admin/config/chat/establishedusermode

Set chat usernames that are not allowed

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of strings

|

Responses

200

Forbidden usernames updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/forbiddenusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/forbiddenusernames

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": ["string" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetForbiddenUsernameListOptions

Responses

204

No Content

options/admin/config/chat/forbiddenusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/forbiddenusernames

Set the suggested chat usernames that will be assigned automatically

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of strings

|

Responses

200

Suggested usernames updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/suggestedusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/suggestedusernames

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": ["string" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetSuggestedUsernameListOptions

Responses

204

No Content

options/admin/config/chat/suggestedusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/suggestedusernames

Set spam protection enabled

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Spam protection enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/spamprotectionenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/spamprotectionenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatSpamProtectionEnabledOptions

Responses

204

No Content

options/admin/config/chat/spamprotectionenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/spamprotectionenabled

Set slur filter enabled

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Slur filter enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/slurfilterenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/slurfilterenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatSlurFilterEnabledOptions

Responses

204

No Content

options/admin/config/chat/slurfilterenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/slurfilterenabled

Set require authentication for chat

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Require authentication setting updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/requireauthentication

Localhost port 8080

http://localhost:8080/api/admin/config/chat/requireauthentication

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatRequireAuthenticationOptions

Responses

204

No Content

options/admin/config/chat/requireauthentication

Localhost port 8080

http://localhost:8080/api/admin/config/chat/requireauthentication

Set video codec

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Video codec updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/video/codec

Localhost port 8080

http://localhost:8080/api/admin/config/video/codec

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetVideoCodecOptions

Responses

204

No Content

options/admin/config/video/codec

Localhost port 8080

http://localhost:8080/api/admin/config/video/codec

Set the number of video segments and duration per segment in a playlist

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Stream latency updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/video/streamlatencylevel

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamlatencylevel

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetStreamLatencyLevelOptions

Responses

204

No Content

options/admin/config/video/streamlatencylevel

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamlatencylevel

Set an array of video output configurations

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of objects (StreamOutputVariant)

|

Responses

200

Stream Output Variants updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/video/streamoutputvariants

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamoutputvariants

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": [ {

"name": "string",

"videoPassthrough": true,

"audioPassthrough": true,

"videoBitrate": 0,

"audioBitrate": 0,

"scaledWidth": 0,

"scaledHeight": 0,

"framerate": 0,

"cpuUsageLevel": 0

}

]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetStreamOutputVariantsOptions

Responses

204

No Content

options/admin/config/video/streamoutputvariants

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamoutputvariants

Set style/color/css values

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object

|

Responses

200

Appearance updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/appearance

Localhost port 8080

http://localhost:8080/api/admin/config/appearance

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"property1": "string",

"property2": "string"

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetCustomColorVariableValuesOptions

Responses

204

No Content

options/admin/config/appearance

Localhost port 8080

http://localhost:8080/api/admin/config/appearance

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Logo updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/logo

Localhost port 8080

http://localhost:8080/api/admin/config/logo

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetLogoOptions

Responses

204

No Content

options/admin/config/logo

Localhost port 8080

http://localhost:8080/api/admin/config/logo

Upload custom favicon

Authorizations:

BasicAuth

Request Body schema: multipart/form-data

| favicon |

string <binary>

Favicon file (PNG or ICO, max 200KB)

|

Responses

200

Favicon updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/favicon

Localhost port 8080

http://localhost:8080/api/admin/config/favicon

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Reset favicon to default

Authorizations:

BasicAuth

Responses

200

Favicon reset to default

401

Basic auth failure

default

Unexpected error

delete/admin/config/favicon

Localhost port 8080

http://localhost:8080/api/admin/config/favicon

Response samples

  • 200
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFaviconOptions

Responses

204

No Content

options/admin/config/favicon

Localhost port 8080

http://localhost:8080/api/admin/config/favicon

Update server tags

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Tags updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/tags

Localhost port 8080

http://localhost:8080/api/admin/config/tags

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetTagsOptions

Responses

204

No Content

options/admin/config/tags

Localhost port 8080

http://localhost:8080/api/admin/config/tags

Update FFMPEG path

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Path updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/ffmpegpath

Localhost port 8080

http://localhost:8080/api/admin/config/ffmpegpath

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFfmpegPathOptions

Responses

204

No Content

options/admin/config/ffmpegpath

Localhost port 8080

http://localhost:8080/api/admin/config/ffmpegpath

Update server port

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Port updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/webserverport

Localhost port 8080

http://localhost:8080/api/admin/config/webserverport

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetWebServerPortOptions

Responses

204

No Content

options/admin/config/webserverport

Localhost port 8080

http://localhost:8080/api/admin/config/webserverport

Update server IP address

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

IP Address updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/webserverip

Localhost port 8080

http://localhost:8080/api/admin/config/webserverip

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetWebServerIPOptions

Responses

204

No Content

options/admin/config/webserverip

Localhost port 8080

http://localhost:8080/api/admin/config/webserverip

Update RTMP post

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

RTMP port updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/rtmpserverport

Localhost port 8080

http://localhost:8080/api/admin/config/rtmpserverport

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetRTMPServerPortOptions

Responses

204

No Content

options/admin/config/rtmpserverport

Localhost port 8080

http://localhost:8080/api/admin/config/rtmpserverport

Update websocket host override

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Websocket host override updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/sockethostoverride

Localhost port 8080

http://localhost:8080/api/admin/config/sockethostoverride

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetSocketHostOverrideOptions

Responses

204

No Content

options/admin/config/sockethostoverride

Localhost port 8080

http://localhost:8080/api/admin/config/sockethostoverride

Update custom video serving endpoint

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Video Serving Endpoint updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/videoservingendpoint

Localhost port 8080

http://localhost:8080/api/admin/config/videoservingendpoint

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetVideoServingEndpointOptions

Responses

204

No Content

options/admin/config/videoservingendpoint

Localhost port 8080

http://localhost:8080/api/admin/config/videoservingendpoint

Update NSFW marking

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

NSFW status updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/nsfw

Localhost port 8080

http://localhost:8080/api/admin/config/nsfw

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetNSFWOptions

Responses

204

No Content

options/admin/config/nsfw

Localhost port 8080

http://localhost:8080/api/admin/config/nsfw

Update directory enabled

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Directory Enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/directoryenabled

Localhost port 8080

http://localhost:8080/api/admin/config/directoryenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetDirectoryEnabledOptions

Responses

204

No Content

options/admin/config/directoryenabled

Localhost port 8080

http://localhost:8080/api/admin/config/directoryenabled

Update social handles

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of objects (SocialHandle)

|

Responses

200

Social handles updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/socialhandles

Localhost port 8080

http://localhost:8080/api/admin/config/socialhandles

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": [ {

"platform": "string",

"url": "string",

"icon": "string"

}

]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetSocialHandlesOptions

Responses

204

No Content

options/admin/config/socialhandles

Localhost port 8080

http://localhost:8080/api/admin/config/socialhandles

Update S3 configuration

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object (S3Info)

|

Responses

200

Directory Enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/s3

Localhost port 8080

http://localhost:8080/api/admin/config/s3

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"endpoint": "string",

"accessKey": "string",

"secret": "string",

"bucket": "string",

"region": "string",

"acl": "string",

"pathPrefix": "string",

"enabled": true,

"forcePathStyle": true

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetS3ConfigurationOptions

Responses

204

No Content

options/admin/config/s3

Localhost port 8080

http://localhost:8080/api/admin/config/s3

Update server url

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Server URL updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/serverurl

Localhost port 8080

http://localhost:8080/api/admin/config/serverurl

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerURLOptions

Responses

204

No Content

options/admin/config/serverurl

Localhost port 8080

http://localhost:8080/api/admin/config/serverurl

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of objects (ExternalAction)

|

Responses

200

External Action Links updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/externalactions

Localhost port 8080

http://localhost:8080/api/admin/config/externalactions

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": [ {

"url": "string",

"html": "string",

"title": "string",

"description": "string",

"icon": "string",

"color": "string",

"openExternally": true

}

]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetExternalActionsOptions

Responses

204

No Content

options/admin/config/externalactions

Localhost port 8080

http://localhost:8080/api/admin/config/externalactions

Update custom styles

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Custom styles updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/customstyles

Localhost port 8080

http://localhost:8080/api/admin/config/customstyles

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetCustomStylesOptions

Responses

204

No Content

options/admin/config/customstyles

Localhost port 8080

http://localhost:8080/api/admin/config/customstyles

Update custom JavaScript

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Custom JavaScript updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/customjavascript

Localhost port 8080

http://localhost:8080/api/admin/config/customjavascript

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetCustomJavascriptOptions

Responses

204

No Content

options/admin/config/customjavascript

Localhost port 8080

http://localhost:8080/api/admin/config/customjavascript

Update hide viewer count

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Hide viewer count updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/hideviewercount

Localhost port 8080

http://localhost:8080/api/admin/config/hideviewercount

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetHideViewerCountOptions

Responses

204

No Content

options/admin/config/hideviewercount

Localhost port 8080

http://localhost:8080/api/admin/config/hideviewercount

Update search indexing

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Search Indexing updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/disablesearchindexing

Localhost port 8080

http://localhost:8080/api/admin/config/disablesearchindexing

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetDisableSearchIndexingOptions

Responses

204

No Content

options/admin/config/disablesearchindexing

Localhost port 8080

http://localhost:8080/api/admin/config/disablesearchindexing

Enable/disable federation features

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation features enabled/disabled

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/enable

Localhost port 8080

http://localhost:8080/api/admin/config/federation/enable

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationEnabledOptions

Responses

204

No Content

options/admin/config/federation/enable

Localhost port 8080

http://localhost:8080/api/admin/config/federation/enable

Set if federation activities are private

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Private status set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/private

Localhost port 8080

http://localhost:8080/api/admin/config/federation/private

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationActivityPrivateOptions

Responses

204

No Content

options/admin/config/federation/private

Localhost port 8080

http://localhost:8080/api/admin/config/federation/private

Set if fediverse engagement appears in chat

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation engagement set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/showengagement

Localhost port 8080

http://localhost:8080/api/admin/config/federation/showengagement

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationShowEngagementOptions

Responses

204

No Content

options/admin/config/federation/showengagement

Localhost port 8080

http://localhost:8080/api/admin/config/federation/showengagement

Set local federated username

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation username set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/username

Localhost port 8080

http://localhost:8080/api/admin/config/federation/username

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationUsernameOptions

Responses

204

No Content

options/admin/config/federation/username

Localhost port 8080

http://localhost:8080/api/admin/config/federation/username

Set federated go live message

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation username set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/livemessage

Localhost port 8080

http://localhost:8080/api/admin/config/federation/livemessage

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationGoLiveMessageOptions

Responses

204

No Content

options/admin/config/federation/livemessage

Localhost port 8080

http://localhost:8080/api/admin/config/federation/livemessage

Set Federation blocked domains

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation blocked domains set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/blockdomains

Localhost port 8080

http://localhost:8080/api/admin/config/federation/blockdomains

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationBlockDomainsOptions

Responses

204

No Content

options/admin/config/federation/blockdomains

Localhost port 8080

http://localhost:8080/api/admin/config/federation/blockdomains

Configure Discord notifications

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object (DiscordNotificationConfiguration)

|

Responses

200

Discord notification configuration updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/notifications/discord

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/discord

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"webhook": "string",

"goLiveMessage": "string",

"enabled": true

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetDiscordNotificationConfigurationOptions

Responses

204

No Content

options/admin/config/notifications/discord

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/discord

Configure Browser notifications

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object (BrowserNotificationConfiguration)

|

Responses

200

Browser notification configuration updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/notifications/browser

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/browser

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"goLiveMessage": "string",

"enabled": true

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetBrowserNotificationConfigurationOptions

Responses

204

No Content

options/admin/config/notifications/browser

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/browser

Get all the webhooks

Authorizations:

BasicAuth

Responses

200

All webhooks

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/webhooks

Localhost port 8080

http://localhost:8080/api/admin/webhooks

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"timestamp": "2019-08-24T14:15:22Z",

"lastUsed": "2019-08-24T14:15:22Z",

"url": "string",

"events": ["CHAT" ],

"id": 0

}

]`

GetWebhooksOptions

Responses

204

No Content

options/admin/webhooks

Localhost port 8080

http://localhost:8080/api/admin/webhooks

Delete a single webhook

Authorizations:

BasicAuth

Request Body schema: application/json

| id |

integer

|

Responses

200

Webhook successfully deleted

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/webhooks/delete

Localhost port 8080

http://localhost:8080/api/admin/webhooks/delete

Request samples

  • Payload

Content type application/json

Copy

`{ "id": 0

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

DeleteWebhookOptions

Responses

204

No Content

options/admin/webhooks/delete

Localhost port 8080

http://localhost:8080/api/admin/webhooks/delete

Create a single webhook

Authorizations:

BasicAuth

Request Body schema: application/json

| url |

string

| | events |

Array of strings (WebhookEventType)

Items Enum: "CHAT" "USER_JOINED" "USER_PARTED" "NAME_CHANGE" "VISIBILITY-UPDATE" "PING" "PONG" "STREAM_STARTED" "STREAM_STOPPED" "STREAM_TITLE_UPDATED" "SYSTEM" "CHAT_ACTION"

|

Responses

200

The new webhook

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/webhooks/create

Localhost port 8080

http://localhost:8080/api/admin/webhooks/create

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"url": "string",

"events": ["CHAT" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"timestamp": "2019-08-24T14:15:22Z",

"lastUsed": "2019-08-24T14:15:22Z",

"url": "string",

"events": ["CHAT" ],

"id": 0

}`

CreateWebhookOptions

Responses

204

No Content

options/admin/webhooks/create

Localhost port 8080

http://localhost:8080/api/admin/webhooks/create

Get all access tokens

Authorizations:

BasicAuth

Responses

200

List of external API users

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/accesstokens

Localhost port 8080

http://localhost:8080/api/admin/accesstokens

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "2019-08-24T14:15:22Z",

"lastUsedAt": "2019-08-24T14:15:22Z",

"id": "string",

"accessToken": "string",

"displayName": "string",

"type": "string",

"scopes": ["string" ],

"displayColor": 0,

"isBot": true

}

]`

GetExternalAPIUsersOptions

Responses

204

No Content

options/admin/accesstokens

Localhost port 8080

http://localhost:8080/api/admin/accesstokens

Delete a single external API user

Authorizations:

BasicAuth

Request Body schema: application/json

| token |

string

|

Responses

200

External API user successfully deleted

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/accesstokens/delete

Localhost port 8080

http://localhost:8080/api/admin/accesstokens/delete

Request samples

  • Payload

Content type application/json

Copy

`{ "token": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

DeleteExternalAPIUserOptions

Responses

204

No Content

options/admin/accesstokens/delete

Localhost port 8080

http://localhost:8080/api/admin/accesstokens/delete

Create a single access token

Authorizations:

BasicAuth

Request Body schema: application/json

| name |

string

| | scopes |

Array of strings

|

Responses

200

The new external API user

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/accesstokens/create

Localhost port 8080

http://localhost:8080/api/admin/accesstokens/create

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"name": "string",

"scopes": ["string" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"createdAt": "2019-08-24T14:15:22Z",

"lastUsedAt": "2019-08-24T14:15:22Z",

"id": "string",

"accessToken": "string",

"displayName": "string",

"type": "string",

"scopes": ["string" ],

"displayColor": 0,

"isBot": true

}`

CreateExternalAPIUserOptions

Responses

204

No Content

options/admin/accesstokens/create

Localhost port 8080

http://localhost:8080/api/admin/accesstokens/create

Return the auto-update features that are supported for this instance

Authorizations:

BasicAuth

Responses

200

Current auto-update options

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/update/options

Localhost port 8080

http://localhost:8080/api/admin/update/options

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"supportsUpdate": true,

"canRestart": true

}`

AutoUpdateOptionsOptions

Responses

204

No Content

options/admin/update/options

Localhost port 8080

http://localhost:8080/api/admin/update/options

Begin the auto-update

Authorizations:

BasicAuth

Responses

200

Console output from update

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/update/start

Localhost port 8080

http://localhost:8080/api/admin/update/start

Response samples

  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

AutoUpdateStartOptions

Responses

204

No Content

options/admin/update/start

Localhost port 8080

http://localhost:8080/api/admin/update/start

Force quit the server and restart it

Authorizations:

BasicAuth

Responses

200

Server force restart has been ordered

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/update/forcequit

Localhost port 8080

http://localhost:8080/api/admin/update/forcequit

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

AutoUpdateForceQuitOptions

Responses

204

No Content

options/admin/update/forcequit

Localhost port 8080

http://localhost:8080/api/admin/update/forcequit

Reset YP configuration

Authorizations:

BasicAuth

Responses

200

YP Registration has been reset

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/yp/reset

Localhost port 8080

http://localhost:8080/api/admin/yp/reset

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

ResetYPRegistrationOptions

Responses

204

No Content

options/admin/yp/reset

Localhost port 8080

http://localhost:8080/api/admin/yp/reset

Get video playback metrics

Authorizations:

BasicAuth

Responses

200

Video playback metrics

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/metrics/video

Localhost port 8080

http://localhost:8080/api/admin/metrics/video

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"errors": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"qualityVariantChanges": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"highestLatency": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"medianLatency": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"lowestLatency": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"medianSegmentDownloadDuration": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"maximumSegmentDownloadDuration": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"minimumSegmentDownloadDuration": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"minPlayerBitrate": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"medianPlayerBitrate": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"maxPlayerBitrate": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"availableBitrates": [0 ],

"segmentLength": 0,

"representation": 0

}`

GetVideoPlaybackMetricsOptions

Responses

204

No Content

options/admin/metrics/video

Localhost port 8080

http://localhost:8080/api/admin/metrics/video

Endpoint to interface with Prometheus

This endpoint interfaces with the Prometheus metrics API.

Learn more about it on the Prometheus API docs

get/admin/prometheus

Localhost port 8080

http://localhost:8080/api/admin/prometheus

Endpoint to interface with Prometheus

This endpoint interfaces with the Prometheus metrics API.

Learn more about it on the Prometheus API docs

post/admin/prometheus

Localhost port 8080

http://localhost:8080/api/admin/prometheus

Endpoint to interface with Prometheus

This endpoint interfaces with the Prometheus metrics API.

Learn more about it on the Prometheus API docs

put/admin/prometheus

Localhost port 8080

http://localhost:8080/api/admin/prometheus

Endpoint to interface with Prometheus

This endpoint interfaces with the Prometheus metrics API.

Learn more about it on the Prometheus API docs

delete/admin/prometheus

Localhost port 8080

http://localhost:8080/api/admin/prometheus

Endpoint to interface with Prometheus

This endpoint interfaces with the Prometheus metrics API.

Learn more about it on the Prometheus API docs

options/admin/prometheus

Localhost port 8080

http://localhost:8080/api/admin/prometheus

Send a public message to the Fediverse from the server's user

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Message sent

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/federation/send

Localhost port 8080

http://localhost:8080/api/admin/federation/send

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SendFederatedMessageOptions

Responses

204

No Content

options/admin/federation/send

Localhost port 8080

http://localhost:8080/api/admin/federation/send

Get a paginated list of federated activities

Authorizations:

BasicAuth

query Parameters

| offset |

integer

The number of items to skip before starting to collect the result set

| | limit |

integer

The numbers of items to return

|

Responses

200

A paginated list of federated activities

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/federation/actions

Localhost port 8080

http://localhost:8080/api/admin/federation/actions

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"total": 0,

"results": {

"timestamp": "2019-08-24T14:15:22Z",

"iri": "string",

"actorIRI": "string",

"type": "string"

}

}`

GetFederatedActionsOptions

Responses

204

No Content

options/admin/federation/actions

Localhost port 8080

http://localhost:8080/api/admin/federation/actions

SendSystemMessageOptions

Responses

204

No Content

options/integrations/chat/system

Localhost port 8080

http://localhost:8080/api/integrations/chat/system

SendSystemMessageToConnectedClientOptions

path Parameters

| clientId required |

integer

The ID of the specified client

|

Responses

204

No Content

options/integrations/chat/system/client/{clientId}

Localhost port 8080

http://localhost:8080/api/integrations/chat/system/client/{clientId}

SendUserMessageOptions Deprecated

Responses

204

No Content

options/integrations/chat/user

Localhost port 8080

http://localhost:8080/api/integrations/chat/user

SendChatActionOptions

Responses

204

No Content

options/integrations/chat/action

Localhost port 8080

http://localhost:8080/api/integrations/chat/action

Begins auth flow

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

| authHost |

string

|

Responses

200

Authentication redirect

400

Bad request

401

Unauthorized

default

Unexpected error

post/auth/indieauth

Localhost port 8080

http://localhost:8080/api/auth/indieauth

Request samples

  • Payload

Content type application/json

Copy

`{ "authHost": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{ "redirect": "string"

}`

Handle the redirect from an IndieAuth server to continue the auth flow

query Parameters

| state required |

string

|

Responses

307

Redirected to home page

400

Bad request

get/auth/indieauth/callback

Localhost port 8080

http://localhost:8080/api/auth/indieauth/callback

Response samples

  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Handles the IndieAuth auth endpoint

Authorizations:

BasicAuth

query Parameters

| client_id required |

string

| | redirect_uri required |

string

| | code_challenge required |

string

| | state required |

string

|

Responses

200

IndieAuth flow concluded

307

Redirected to redirect URI

400

Bad request

500

Internal Server Error

get/auth/provider/indieauth

Localhost port 8080

http://localhost:8080/api/auth/provider/indieauth

Response samples

  • 200
  • 400
  • 500

Content type application/json

Copy Expand all Collapse all

`{

"me": "string",

"profile": {

"name": "string",

"url": "string",

"photo": "string"

},

"error": "string",

"errorDescription": "string"

}`

Handles IndieAuth from form submission

Request Body schema: application/x-www-form-urlencoded

Form submission from IndieAuth

| code |

string

| | redirect_uri |

string

| | client_id |

string

| | codeVerifier |

string

|

Responses

200

IndieAuth flow concluded

400

Bad request

post/auth/provider/indieauth

Localhost port 8080

http://localhost:8080/api/auth/provider/indieauth

Response samples

  • 200
  • 400

Content type application/json

Example IndieAuthResponseIndieAuthServerProfileResponseIndieAuthResponse

Copy Expand all Collapse all

`{

"me": "string",

"profile": {

"name": "string",

"url": "string",

"photo": "string"

},

"error": "string",

"errorDescription": "string"

}`

Register a Fediverse OTP request

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

| account |

string

|

Responses

200

OTP sent

400

Bad request

401

Unauthorized

post/auth/fediverse

Localhost port 8080

http://localhost:8080/api/auth/fediverse

Request samples

  • Payload

Content type application/json

Copy

`{ "account": "string"

}`

Response samples

  • 200
  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Verify Fediverse OTP code

Request Body schema: application/json

| code |

string

|

Responses

200

OTP Verified

400

Bad request

403

Forbidden

post/auth/fediverse/verify

Localhost port 8080

http://localhost:8080/api/auth/fediverse/verify

Request samples

  • Payload

Content type application/json

Copy

`{ "code": "string"

}`

Response samples

  • 200
  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Auth

Authentication API

Begins auth flow

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

| authHost |

string

|

Responses

200

Authentication redirect

400

Bad request

401

Unauthorized

default

Unexpected error

post/auth/indieauth

Localhost port 8080

http://localhost:8080/api/auth/indieauth

Request samples

  • Payload

Content type application/json

Copy

`{ "authHost": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{ "redirect": "string"

}`

Handle the redirect from an IndieAuth server to continue the auth flow

query Parameters

| state required |

string

|

Responses

307

Redirected to home page

400

Bad request

get/auth/indieauth/callback

Localhost port 8080

http://localhost:8080/api/auth/indieauth/callback

Response samples

  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Handles the IndieAuth auth endpoint

Authorizations:

BasicAuth

query Parameters

| client_id required |

string

| | redirect_uri required |

string

| | code_challenge required |

string

| | state required |

string

|

Responses

200

IndieAuth flow concluded

307

Redirected to redirect URI

400

Bad request

500

Internal Server Error

get/auth/provider/indieauth

Localhost port 8080

http://localhost:8080/api/auth/provider/indieauth

Response samples

  • 200
  • 400
  • 500

Content type application/json

Copy Expand all Collapse all

`{

"me": "string",

"profile": {

"name": "string",

"url": "string",

"photo": "string"

},

"error": "string",

"errorDescription": "string"

}`

Handles IndieAuth from form submission

Request Body schema: application/x-www-form-urlencoded

Form submission from IndieAuth

| code |

string

| | redirect_uri |

string

| | client_id |

string

| | codeVerifier |

string

|

Responses

200

IndieAuth flow concluded

400

Bad request

post/auth/provider/indieauth

Localhost port 8080

http://localhost:8080/api/auth/provider/indieauth

Response samples

  • 200
  • 400

Content type application/json

Example IndieAuthResponseIndieAuthServerProfileResponseIndieAuthResponse

Copy Expand all Collapse all

`{

"me": "string",

"profile": {

"name": "string",

"url": "string",

"photo": "string"

},

"error": "string",

"errorDescription": "string"

}`

Register a Fediverse OTP request

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

| account |

string

|

Responses

200

OTP sent

400

Bad request

401

Unauthorized

post/auth/fediverse

Localhost port 8080

http://localhost:8080/api/auth/fediverse

Request samples

  • Payload

Content type application/json

Copy

`{ "account": "string"

}`

Response samples

  • 200
  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Verify Fediverse OTP code

Request Body schema: application/json

| code |

string

|

Responses

200

OTP Verified

400

Bad request

403

Forbidden

post/auth/fediverse/verify

Localhost port 8080

http://localhost:8080/api/auth/fediverse/verify

Request samples

  • Payload

Content type application/json

Copy

`{ "code": "string"

}`

Response samples

  • 200
  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Chat

APIs related to operating the chat system.

Get list of custom emojis supported in the chat

Responses

200

List of valid emojis

500

Internal Server Error

get/emoji

Localhost port 8080

http://localhost:8080/api/emoji

Response samples

  • 200
  • 500

Content type application/json

Copy Expand all Collapse all

`[ {

"name": "string",

"url": "string"

}

]`

Gets a list of chat messages

query Parameters

| accessToken required |

string

|

Responses

200

List of chat messages

401

Unauthorized

501

Not Implemented

get/chat

Localhost port 8080

http://localhost:8080/api/chat

Response samples

  • 200
  • 501

Content type application/json

Copy Expand all Collapse all

`[ {

"timestamp": "string",

"type": "string",

"id": "string",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"hiddenAt": "string",

"clientId": 0,

"body": "string"

}

]`

Registers an anonymous chat user

header Parameters

| X-Forwarded-User |

string

|

Request Body schema: application/json optional

The display name of the new user

| displayName |

string

|

Responses

200

Anonymous user information

400

Bad request

post/chat/register

Localhost port 8080

http://localhost:8080/api/chat/register

Request samples

  • Payload

Content type application/json

Copy

`{ "displayName": "string"

}`

Response samples

  • 200
  • 400

Content type application/json

Copy

`{

"id": "string",

"accessToken": "string",

"displayName": "string"

}`

RegisterAnonymousChatUserOptions

Responses

204

No Content

options/chat/register

Localhost port 8080

http://localhost:8080/api/chat/register

Update chat message visibility

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

| idArray |

Array of strings

| | visible |

boolean

|

Responses

200

Message visibility updated

400

Bad request

401

Unauthorized

default

Unexpected error

post/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/chat/messagevisibility

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"idArray": ["string" ],

"visible": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Enable/disable a user

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

| userId |

string

| | enabled |

boolean

|

Responses

200

User status has been updated

400

Bad request

401

Unauthorized

default

Unexpected error

post/chat/users/setenabled

Localhost port 8080

http://localhost:8080/api/chat/users/setenabled

Request samples

  • Payload

Content type application/json

Copy

`{

"userId": "string",

"enabled": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get a detailed list of currently connected chat clients

Authorizations:

BasicAuth

Responses

200

List of chat clients

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/clients

Localhost port 8080

http://localhost:8080/api/admin/chat/clients

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"connectedAt": "2019-08-24T14:15:22Z",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"geo": {

"countryCode": "string",

"regionName": "string",

"timeZone": "string"

},

"userAgent": "string",

"messageCount": 0

}

]`

GetConnectedChatClientsOptions

Responses

204

No Content

options/admin/chat/clients

Localhost port 8080

http://localhost:8080/api/admin/chat/clients

Get all chat messages for the admin, unfiltered

Authorizations:

BasicAuth

Responses

200

List of chat messages for the admin

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/messages

Localhost port 8080

http://localhost:8080/api/admin/chat/messages

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"timestamp": "string",

"type": "string",

"id": "string",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"hiddenAt": "string",

"clientId": 0,

"body": "string"

}

]`

GetChatMessagesAdminOptions

Responses

204

No Content

options/admin/chat/messages

Localhost port 8080

http://localhost:8080/api/admin/chat/messages

Update visibility of chat messages

Authorizations:

BasicAuth

Request Body schema: application/json

| idArray |

Array of strings

| | visible |

boolean

|

Responses

200

Messages updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/admin/chat/messagevisibility

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"idArray": ["string" ],

"visible": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

UpdateMessageVisibilityAdminOptions

Responses

204

No Content

options/admin/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/admin/chat/messagevisibility

Enable or disable a user

Authorizations:

BasicAuth

Request Body schema: application/json

| userId |

string

| | enabled |

boolean

|

Responses

200

Successfully updated the user

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/setenabled

Localhost port 8080

http://localhost:8080/api/admin/chat/users/setenabled

Request samples

  • Payload

Content type application/json

Copy

`{

"userId": "string",

"enabled": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

UpdateUserEnabledAdminOptions

Responses

204

No Content

options/admin/chat/users/setenabled

Localhost port 8080

http://localhost:8080/api/admin/chat/users/setenabled

Get a list of disabled users

Authorizations:

BasicAuth

Responses

200

List of disabled users

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/users/disabled

Localhost port 8080

http://localhost:8080/api/admin/chat/users/disabled

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

}

]`

GetDisabledUsersOptions

Responses

204

No Content

options/admin/chat/users/disabled

Localhost port 8080

http://localhost:8080/api/admin/chat/users/disabled

Ban an IP address

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

IP was successfully banned

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/ipbans/create

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans/create

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

BanIPAddressOptions

Responses

204

No Content

options/admin/chat/users/ipbans/create

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans/create

Remove an IP ban

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

string or boolean or Array of strings or number

|

Responses

200

IP ban was successfully removed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/ipbans/remove

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans/remove

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

UnbanIPAddressOptions

Responses

204

No Content

options/admin/chat/users/ipbans/remove

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans/remove

Get all banned IP addresses

Authorizations:

BasicAuth

Responses

200

List of banned IP addresses

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/users/ipbans

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "2019-08-24T14:15:22Z",

"ipAddress": "string",

"notes": "string"

}

]`

GetIPAddressBansOptions

Responses

204

No Content

options/admin/chat/users/ipbans

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans

Set moderator status for a user

Authorizations:

BasicAuth

Request Body schema: application/json

| userId |

string

| | isModerator |

boolean

|

Responses

200

Successfully update the moderator status of the user

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/setmoderator

Localhost port 8080

http://localhost:8080/api/admin/chat/users/setmoderator

Request samples

  • Payload

Content type application/json

Copy

`{

"userId": "string",

"isModerator": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

UpdateUserModeratorOptions

Responses

204

No Content

options/admin/chat/users/setmoderator

Localhost port 8080

http://localhost:8080/api/admin/chat/users/setmoderator

Get a list of moderator users

Authorizations:

BasicAuth

Responses

200

List of moderator users

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/users/moderators

Localhost port 8080

http://localhost:8080/api/admin/chat/users/moderators

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

}

]`

Upload custom emoji

Authorizations:

BasicAuth

Request Body schema: application/json

| name |

string

| | data |

string

Base 64 encoded image data

|

Responses

200

Emoji has been uploaded

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/emoji/upload

Localhost port 8080

http://localhost:8080/api/admin/emoji/upload

Request samples

  • Payload

Content type application/json

Copy

`{

"name": "string",

"data": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

UploadCustomEmojiOptions

Responses

204

No Content

options/admin/emoji/upload

Localhost port 8080

http://localhost:8080/api/admin/emoji/upload

Delete custom emoji

Authorizations:

BasicAuth

Request Body schema: application/json

| name |

string

|

Responses

200

Emoji has been deleted

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/emoji/delete

Localhost port 8080

http://localhost:8080/api/admin/emoji/delete

Request samples

  • Payload

Content type application/json

Copy

`{ "name": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

DeleteCustomEmojiOptions

Responses

204

No Content

options/admin/emoji/delete

Localhost port 8080

http://localhost:8080/api/admin/emoji/delete

Change the welcome message

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Welcome message has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/welcomemessage

Localhost port 8080

http://localhost:8080/api/admin/config/welcomemessage

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerWelcomeMessageOptions

Responses

204

No Content

options/admin/config/welcomemessage

Localhost port 8080

http://localhost:8080/api/admin/config/welcomemessage

Disable chat

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Chat has been disabled

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/disable

Localhost port 8080

http://localhost:8080/api/admin/config/chat/disable

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatDisabledOptions

Responses

204

No Content

options/admin/config/chat/disable

Localhost port 8080

http://localhost:8080/api/admin/config/chat/disable

Enable chat for user join messages

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

User join messages has been enabled

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/joinmessagesenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/joinmessagesenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatJoinMessagesEnabledOptions

Responses

204

No Content

options/admin/config/chat/joinmessagesenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/joinmessagesenabled

Enable/disable chat established user mode

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Chat established user mode updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/establishedusermode

Localhost port 8080

http://localhost:8080/api/admin/config/chat/establishedusermode

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetEnableEstablishedChatUserModeOptions

Responses

204

No Content

options/admin/config/chat/establishedusermode

Localhost port 8080

http://localhost:8080/api/admin/config/chat/establishedusermode

Set chat usernames that are not allowed

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of strings

|

Responses

200

Forbidden usernames updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/forbiddenusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/forbiddenusernames

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": ["string" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetForbiddenUsernameListOptions

Responses

204

No Content

options/admin/config/chat/forbiddenusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/forbiddenusernames

Set the suggested chat usernames that will be assigned automatically

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of strings

|

Responses

200

Suggested usernames updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/suggestedusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/suggestedusernames

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": ["string" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetSuggestedUsernameListOptions

Responses

204

No Content

options/admin/config/chat/suggestedusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/suggestedusernames

Set spam protection enabled

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Spam protection enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/spamprotectionenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/spamprotectionenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatSpamProtectionEnabledOptions

Responses

204

No Content

options/admin/config/chat/spamprotectionenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/spamprotectionenabled

Set slur filter enabled

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Slur filter enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/slurfilterenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/slurfilterenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatSlurFilterEnabledOptions

Responses

204

No Content

options/admin/config/chat/slurfilterenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/slurfilterenabled

Set require authentication for chat

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Require authentication setting updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/requireauthentication

Localhost port 8080

http://localhost:8080/api/admin/config/chat/requireauthentication

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatRequireAuthenticationOptions

Responses

204

No Content

options/admin/config/chat/requireauthentication

Localhost port 8080

http://localhost:8080/api/admin/config/chat/requireauthentication

Update websocket host override

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Websocket host override updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/sockethostoverride

Localhost port 8080

http://localhost:8080/api/admin/config/sockethostoverride

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetSocketHostOverrideOptions

Responses

204

No Content

options/admin/config/sockethostoverride

Localhost port 8080

http://localhost:8080/api/admin/config/sockethostoverride

Send a system message to the chat

Authorizations:

BearerAuth

Request Body schema: application/json

The content of the system message

| body |

string

|

Responses

200

Message sent successfully

400

Bad request

401

Unauthorized

500

Internal Server Error

default

Unexpected error

post/integrations/chat/system

Localhost port 8080

http://localhost:8080/api/integrations/chat/system

Request samples

  • Payload

Content type application/json

Copy

`{ "body": "string"

}`

Response samples

  • 200
  • 400
  • 500
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SendSystemMessageOptions

Responses

204

No Content

options/integrations/chat/system

Localhost port 8080

http://localhost:8080/api/integrations/chat/system

Send a system message to a single client

Authorizations:

BearerAuth

path Parameters

| clientId required |

integer

The ID of the specified client

|

Request Body schema: application/json

| timestamp |

string

| | type |

string

| | id |

string

| | body |

string

|

Responses

400

Bad request

401

Unauthorized

500

Internal Server Error

default

Unexpected error

post/integrations/chat/system/client/{clientId}

Localhost port 8080

http://localhost:8080/api/integrations/chat/system/client/{clientId}

Request samples

  • Payload

Content type application/json

Copy

`{

"timestamp": "string",

"type": "string",

"id": "string",

"body": "string"

}`

Response samples

  • 400
  • 500
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SendSystemMessageToConnectedClientOptions

path Parameters

| clientId required |

integer

The ID of the specified client

|

Responses

204

No Content

options/integrations/chat/system/client/{clientId}

Localhost port 8080

http://localhost:8080/api/integrations/chat/system/client/{clientId}

Send a user message to chat Deprecated

Authorizations:

BearerAuth

Responses

400

Bad request

post/integrations/chat/user

Localhost port 8080

http://localhost:8080/api/integrations/chat/user

Response samples

  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SendUserMessageOptions Deprecated

Responses

204

No Content

options/integrations/chat/user

Localhost port 8080

http://localhost:8080/api/integrations/chat/user

Send a message to chat as a specific 3rd party bot/integration based on its access token

Authorizations:

BearerAuth

Request Body schema: application/json

| body |

string

|

Responses

200

Message sent successfully

400

Bad request

401

Unauthorized

500

Internal Server Error

default

Unexpected error

post/integrations/chat/send

Localhost port 8080

http://localhost:8080/api/integrations/chat/send

Request samples

  • Payload

Content type application/json

Copy

`{ "body": "string"

}`

Response samples

  • 200
  • 400
  • 500
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SendIntegrationChatMessageOptions

Responses

204

No Content

options/integrations/chat/send

Localhost port 8080

http://localhost:8080/api/integrations/chat/send

Send a user action to chat

Authorizations:

BearerAuth

Request Body schema: application/json

| body |

string

|

Responses

200

Action sent successfully

400

Bad request

401

Unauthorized

500

Internal Server Error

default

Unexpected error

post/integrations/chat/action

Localhost port 8080

http://localhost:8080/api/integrations/chat/action

Request samples

  • Payload

Content type application/json

Copy

`{ "body": "string"

}`

Response samples

  • 200
  • 400
  • 500
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SendChatActionOptions

Responses

204

No Content

options/integrations/chat/action

Localhost port 8080

http://localhost:8080/api/integrations/chat/action

Hide chat message

Authorizations:

BearerAuth

Request Body schema: application/json

| idArray |

Array of strings

| | visible |

boolean

|

Responses

200

Messages updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/integrations/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/integrations/chat/messagevisibility

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"idArray": ["string" ],

"visible": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

ExternalUpdateMessageVisibilityOptions

Responses

204

No Content

options/integrations/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/integrations/chat/messagevisibility

Get chat history

Authorizations:

BearerAuth

Responses

200

List of chat messages

401

Unauthorized

501

Not Implemented

default

Unexpected error

get/integrations/chat

Localhost port 8080

http://localhost:8080/api/integrations/chat

Response samples

  • 200
  • 501
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"timestamp": "string",

"type": "string",

"id": "string",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"hiddenAt": "string",

"clientId": 0,

"body": "string"

}

]`

ExternalGetChatMessagesOptions

Responses

204

No Content

options/integrations/chat

Localhost port 8080

http://localhost:8080/api/integrations/chat

Connected clients

Authorizations:

BearerAuth

Responses

200

List of chat clients

400

Bad request

401

Basic auth failure

default

Unexpected error

get/integrations/clients

Localhost port 8080

http://localhost:8080/api/integrations/clients

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"connectedAt": "2019-08-24T14:15:22Z",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"geo": {

"countryCode": "string",

"regionName": "string",

"timeZone": "string"

},

"userAgent": "string",

"messageCount": 0

}

]`

ExternalGetConnectedChatClientsOptions

Responses

204

No Content

options/integrations/clients

Localhost port 8080

http://localhost:8080/api/integrations/clients

Get a user's details

Authorizations:

BearerAuth

path Parameters

| userId required |

string

The ID of the user to find

|

Responses

200

User information

401

Basic auth failure

404

Not found

default

Unexpected error

get/integrations/moderation/chat/user/{userId}

Localhost port 8080

http://localhost:8080/api/integrations/moderation/chat/user/{userId}

Response samples

  • 200
  • default

Content type application/json

Copy Expand all Collapse all

`{

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"connectedClients": [ {

"connectedAt": "2019-08-24T14:15:22Z",

"userAgent": "string",

"geo": "string",

"id": 0,

"messageCount": 0

}

],

"messages": [ {

"timestamp": "string",

"type": "string",

"id": "string",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"hiddenAt": "string",

"clientId": 0,

"body": "string"

}

]

}`

Get a user's details

path Parameters

| userId required |

string

The ID of the user to find

|

query Parameters

| accessToken required |

string

|

Responses

200

User information

401

Unauthorized

404

Not found

default

Unexpected error

get/moderation/chat/user/{userId}

Localhost port 8080

http://localhost:8080/api/moderation/chat/user/{userId}

Response samples

  • 200
  • default

Content type application/json

Copy Expand all Collapse all

`{

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"connectedClients": [ {

"connectedAt": "2019-08-24T14:15:22Z",

"userAgent": "string",

"geo": "string",

"id": 0,

"messageCount": 0

}

],

"messages": [ {

"timestamp": "string",

"type": "string",

"id": "string",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"hiddenAt": "string",

"clientId": 0,

"body": "string"

}

]

}`

Begins auth flow

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

| authHost |

string

|

Responses

200

Authentication redirect

400

Bad request

401

Unauthorized

default

Unexpected error

post/auth/indieauth

Localhost port 8080

http://localhost:8080/api/auth/indieauth

Request samples

  • Payload

Content type application/json

Copy

`{ "authHost": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{ "redirect": "string"

}`

Handle the redirect from an IndieAuth server to continue the auth flow

query Parameters

| state required |

string

|

Responses

307

Redirected to home page

400

Bad request

get/auth/indieauth/callback

Localhost port 8080

http://localhost:8080/api/auth/indieauth/callback

Response samples

  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Handles the IndieAuth auth endpoint

Authorizations:

BasicAuth

query Parameters

| client_id required |

string

| | redirect_uri required |

string

| | code_challenge required |

string

| | state required |

string

|

Responses

200

IndieAuth flow concluded

307

Redirected to redirect URI

400

Bad request

500

Internal Server Error

get/auth/provider/indieauth

Localhost port 8080

http://localhost:8080/api/auth/provider/indieauth

Response samples

  • 200
  • 400
  • 500

Content type application/json

Copy Expand all Collapse all

`{

"me": "string",

"profile": {

"name": "string",

"url": "string",

"photo": "string"

},

"error": "string",

"errorDescription": "string"

}`

Handles IndieAuth from form submission

Request Body schema: application/x-www-form-urlencoded

Form submission from IndieAuth

| code |

string

| | redirect_uri |

string

| | client_id |

string

| | codeVerifier |

string

|

Responses

200

IndieAuth flow concluded

400

Bad request

post/auth/provider/indieauth

Localhost port 8080

http://localhost:8080/api/auth/provider/indieauth

Response samples

  • 200
  • 400

Content type application/json

Example IndieAuthResponseIndieAuthServerProfileResponseIndieAuthResponse

Copy Expand all Collapse all

`{

"me": "string",

"profile": {

"name": "string",

"url": "string",

"photo": "string"

},

"error": "string",

"errorDescription": "string"

}`

Register a Fediverse OTP request

query Parameters

| accessToken required |

string

|

Request Body schema: application/json

| account |

string

|

Responses

200

OTP sent

400

Bad request

401

Unauthorized

post/auth/fediverse

Localhost port 8080

http://localhost:8080/api/auth/fediverse

Request samples

  • Payload

Content type application/json

Copy

`{ "account": "string"

}`

Response samples

  • 200
  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Verify Fediverse OTP code

Request Body schema: application/json

| code |

string

|

Responses

200

OTP Verified

400

Bad request

403

Forbidden

post/auth/fediverse/verify

Localhost port 8080

http://localhost:8080/api/auth/fediverse/verify

Request samples

  • Payload

Content type application/json

Copy

`{ "code": "string"

}`

Response samples

  • 200
  • 400

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Objects

Object definitions

RegisterAnonymousChatUserOptions

Responses

204

No Content

options/chat/register

Localhost port 8080

http://localhost:8080/api/chat/register

StatusAdminOptions

Responses

204

No Content

options/admin/status

Localhost port 8080

http://localhost:8080/api/admin/status

DisconnectInboundConnectionOptions

Responses

204

No Content

options/admin/disconnect

Localhost port 8080

http://localhost:8080/api/admin/disconnect

GetServerConfigOptions

Responses

204

No Content

options/admin/serverconfig

Localhost port 8080

http://localhost:8080/api/admin/serverconfig

GetViewersOverTimeOptions

Responses

204

No Content

options/admin/viewersOverTime

Localhost port 8080

http://localhost:8080/api/admin/viewersOverTime

GetActiveViewersOptions

Responses

204

No Content

options/admin/viewers

Localhost port 8080

http://localhost:8080/api/admin/viewers

GetHardwareStatsOptions

Responses

204

No Content

options/admin/hardwarestats

Localhost port 8080

http://localhost:8080/api/admin/hardwarestats

GetConnectedChatClientsOptions

Responses

204

No Content

options/admin/chat/clients

Localhost port 8080

http://localhost:8080/api/admin/chat/clients

GetChatMessagesAdminOptions

Responses

204

No Content

options/admin/chat/messages

Localhost port 8080

http://localhost:8080/api/admin/chat/messages

UpdateMessageVisibilityAdminOptions

Responses

204

No Content

options/admin/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/admin/chat/messagevisibility

UpdateUserEnabledAdminOptions

Responses

204

No Content

options/admin/chat/users/setenabled

Localhost port 8080

http://localhost:8080/api/admin/chat/users/setenabled

GetDisabledUsersOptions

Responses

204

No Content

options/admin/chat/users/disabled

Localhost port 8080

http://localhost:8080/api/admin/chat/users/disabled

BanIPAddressOptions

Responses

204

No Content

options/admin/chat/users/ipbans/create

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans/create

UnbanIPAddressOptions

Responses

204

No Content

options/admin/chat/users/ipbans/remove

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans/remove

GetIPAddressBansOptions

Responses

204

No Content

options/admin/chat/users/ipbans

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans

UpdateUserModeratorOptions

Responses

204

No Content

options/admin/chat/users/setmoderator

Localhost port 8080

http://localhost:8080/api/admin/chat/users/setmoderator

GetModeratorsOptions

Responses

204

No Content

options/admin/chat/users/moderators

Localhost port 8080

http://localhost:8080/api/admin/chat/users/moderators

GetLogsOptions

Responses

204

No Content

options/admin/logs

Localhost port 8080

http://localhost:8080/api/admin/logs

GetWarningsOptions

Responses

204

No Content

options/admin/logs/warnings

Localhost port 8080

http://localhost:8080/api/admin/logs/warnings

GetFollowersAdminOptions

Responses

204

No Content

options/admin/followers

Localhost port 8080

http://localhost:8080/api/admin/followers

GetPendingFollowRequestsOptions

Responses

204

No Content

options/admin/followers/pending

Localhost port 8080

http://localhost:8080/api/admin/followers/pending

GetBlockedAndRejectedFollowersOptions

Responses

204

No Content

options/admin/followers/blocked

Localhost port 8080

http://localhost:8080/api/admin/followers/blocked

ApproveFollowerOptions

Responses

204

No Content

options/admin/followers/approve

Localhost port 8080

http://localhost:8080/api/admin/followers/approve

UploadCustomEmojiOptions

Responses

204

No Content

options/admin/emoji/upload

Localhost port 8080

http://localhost:8080/api/admin/emoji/upload

DeleteCustomEmojiOptions

Responses

204

No Content

options/admin/emoji/delete

Localhost port 8080

http://localhost:8080/api/admin/emoji/delete

SetAdminPasswordOptions

Responses

204

No Content

options/admin/config/adminpass

Localhost port 8080

http://localhost:8080/api/admin/config/adminpass

SetStreamKeysOptions

Responses

204

No Content

options/admin/config/streamkeys

Localhost port 8080

http://localhost:8080/api/admin/config/streamkeys

SetExtraPageContentOptions

Responses

204

No Content

options/admin/config/pagecontent

Localhost port 8080

http://localhost:8080/api/admin/config/pagecontent

SetStreamTitleOptions

Responses

204

No Content

options/admin/config/streamtitle

Localhost port 8080

http://localhost:8080/api/admin/config/streamtitle

Change the server name

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Server name has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/name

Localhost port 8080

http://localhost:8080/api/admin/config/name

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerNameOptions

Responses

204

No Content

options/admin/config/name

Localhost port 8080

http://localhost:8080/api/admin/config/name

Change the server summary

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Server summary has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/serversummary

Localhost port 8080

http://localhost:8080/api/admin/config/serversummary

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerSummaryOptions

Responses

204

No Content

options/admin/config/serversummary

Localhost port 8080

http://localhost:8080/api/admin/config/serversummary

Change the offline message

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Offline message has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/offlinemessage

Localhost port 8080

http://localhost:8080/api/admin/config/offlinemessage

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetCustomOfflineMessageOptions

Responses

204

No Content

options/admin/config/offlinemessage

Localhost port 8080

http://localhost:8080/api/admin/config/offlinemessage

SetServerWelcomeMessageOptions

Responses

204

No Content

options/admin/config/welcomemessage

Localhost port 8080

http://localhost:8080/api/admin/config/welcomemessage

SetChatDisabledOptions

Responses

204

No Content

options/admin/config/chat/disable

Localhost port 8080

http://localhost:8080/api/admin/config/chat/disable

SetChatJoinMessagesEnabledOptions

Responses

204

No Content

options/admin/config/chat/joinmessagesenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/joinmessagesenabled

SetEnableEstablishedChatUserModeOptions

Responses

204

No Content

options/admin/config/chat/establishedusermode

Localhost port 8080

http://localhost:8080/api/admin/config/chat/establishedusermode

SetForbiddenUsernameListOptions

Responses

204

No Content

options/admin/config/chat/forbiddenusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/forbiddenusernames

SetSuggestedUsernameListOptions

Responses

204

No Content

options/admin/config/chat/suggestedusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/suggestedusernames

SetChatSpamProtectionEnabledOptions

Responses

204

No Content

options/admin/config/chat/spamprotectionenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/spamprotectionenabled

SetChatSlurFilterEnabledOptions

Responses

204

No Content

options/admin/config/chat/slurfilterenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/slurfilterenabled

SetChatRequireAuthenticationOptions

Responses

204

No Content

options/admin/config/chat/requireauthentication

Localhost port 8080

http://localhost:8080/api/admin/config/chat/requireauthentication

SetVideoCodecOptions

Responses

204

No Content

options/admin/config/video/codec

Localhost port 8080

http://localhost:8080/api/admin/config/video/codec

SetStreamLatencyLevelOptions

Responses

204

No Content

options/admin/config/video/streamlatencylevel

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamlatencylevel

SetStreamOutputVariantsOptions

Responses

204

No Content

options/admin/config/video/streamoutputvariants

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamoutputvariants

SetCustomColorVariableValuesOptions

Responses

204

No Content

options/admin/config/appearance

Localhost port 8080

http://localhost:8080/api/admin/config/appearance

SetLogoOptions

Responses

204

No Content

options/admin/config/logo

Localhost port 8080

http://localhost:8080/api/admin/config/logo

SetFaviconOptions

Responses

204

No Content

options/admin/config/favicon

Localhost port 8080

http://localhost:8080/api/admin/config/favicon

SetTagsOptions

Responses

204

No Content

options/admin/config/tags

Localhost port 8080

http://localhost:8080/api/admin/config/tags

SetFfmpegPathOptions

Responses

204

No Content

options/admin/config/ffmpegpath

Localhost port 8080

http://localhost:8080/api/admin/config/ffmpegpath

SetWebServerPortOptions

Responses

204

No Content

options/admin/config/webserverport

Localhost port 8080

http://localhost:8080/api/admin/config/webserverport

SetWebServerIPOptions

Responses

204

No Content

options/admin/config/webserverip

Localhost port 8080

http://localhost:8080/api/admin/config/webserverip

SetRTMPServerPortOptions

Responses

204

No Content

options/admin/config/rtmpserverport

Localhost port 8080

http://localhost:8080/api/admin/config/rtmpserverport

SetSocketHostOverrideOptions

Responses

204

No Content

options/admin/config/sockethostoverride

Localhost port 8080

http://localhost:8080/api/admin/config/sockethostoverride

SetVideoServingEndpointOptions

Responses

204

No Content

options/admin/config/videoservingendpoint

Localhost port 8080

http://localhost:8080/api/admin/config/videoservingendpoint

SetNSFWOptions

Responses

204

No Content

options/admin/config/nsfw

Localhost port 8080

http://localhost:8080/api/admin/config/nsfw

SetDirectoryEnabledOptions

Responses

204

No Content

options/admin/config/directoryenabled

Localhost port 8080

http://localhost:8080/api/admin/config/directoryenabled

SetSocialHandlesOptions

Responses

204

No Content

options/admin/config/socialhandles

Localhost port 8080

http://localhost:8080/api/admin/config/socialhandles

SetS3ConfigurationOptions

Responses

204

No Content

options/admin/config/s3

Localhost port 8080

http://localhost:8080/api/admin/config/s3

SetServerURLOptions

Responses

204

No Content

options/admin/config/serverurl

Localhost port 8080

http://localhost:8080/api/admin/config/serverurl

SetExternalActionsOptions

Responses

204

No Content

options/admin/config/externalactions

Localhost port 8080

http://localhost:8080/api/admin/config/externalactions

SetCustomStylesOptions

Responses

204

No Content

options/admin/config/customstyles

Localhost port 8080

http://localhost:8080/api/admin/config/customstyles

SetCustomJavascriptOptions

Responses

204

No Content

options/admin/config/customjavascript

Localhost port 8080

http://localhost:8080/api/admin/config/customjavascript

SetHideViewerCountOptions

Responses

204

No Content

options/admin/config/hideviewercount

Localhost port 8080

http://localhost:8080/api/admin/config/hideviewercount

SetDisableSearchIndexingOptions

Responses

204

No Content

options/admin/config/disablesearchindexing

Localhost port 8080

http://localhost:8080/api/admin/config/disablesearchindexing

SetFederationEnabledOptions

Responses

204

No Content

options/admin/config/federation/enable

Localhost port 8080

http://localhost:8080/api/admin/config/federation/enable

SetFederationActivityPrivateOptions

Responses

204

No Content

options/admin/config/federation/private

Localhost port 8080

http://localhost:8080/api/admin/config/federation/private

SetFederationShowEngagementOptions

Responses

204

No Content

options/admin/config/federation/showengagement

Localhost port 8080

http://localhost:8080/api/admin/config/federation/showengagement

SetFederationUsernameOptions

Responses

204

No Content

options/admin/config/federation/username

Localhost port 8080

http://localhost:8080/api/admin/config/federation/username

SetFederationGoLiveMessageOptions

Responses

204

No Content

options/admin/config/federation/livemessage

Localhost port 8080

http://localhost:8080/api/admin/config/federation/livemessage

SetFederationBlockDomainsOptions

Responses

204

No Content

options/admin/config/federation/blockdomains

Localhost port 8080

http://localhost:8080/api/admin/config/federation/blockdomains

SetDiscordNotificationConfigurationOptions

Responses

204

No Content

options/admin/config/notifications/discord

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/discord

SetBrowserNotificationConfigurationOptions

Responses

204

No Content

options/admin/config/notifications/browser

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/browser

GetWebhooksOptions

Responses

204

No Content

options/admin/webhooks

Localhost port 8080

http://localhost:8080/api/admin/webhooks

DeleteWebhookOptions

Responses

204

No Content

options/admin/webhooks/delete

Localhost port 8080

http://localhost:8080/api/admin/webhooks/delete

CreateWebhookOptions

Responses

204

No Content

options/admin/webhooks/create

Localhost port 8080

http://localhost:8080/api/admin/webhooks/create

GetExternalAPIUsersOptions

Responses

204

No Content

options/admin/accesstokens

Localhost port 8080

http://localhost:8080/api/admin/accesstokens

DeleteExternalAPIUserOptions

Responses

204

No Content

options/admin/accesstokens/delete

Localhost port 8080

http://localhost:8080/api/admin/accesstokens/delete

CreateExternalAPIUserOptions

Responses

204

No Content

options/admin/accesstokens/create

Localhost port 8080

http://localhost:8080/api/admin/accesstokens/create

AutoUpdateOptionsOptions

Responses

204

No Content

options/admin/update/options

Localhost port 8080

http://localhost:8080/api/admin/update/options

AutoUpdateStartOptions

Responses

204

No Content

options/admin/update/start

Localhost port 8080

http://localhost:8080/api/admin/update/start

AutoUpdateForceQuitOptions

Responses

204

No Content

options/admin/update/forcequit

Localhost port 8080

http://localhost:8080/api/admin/update/forcequit

ResetYPRegistrationOptions

Responses

204

No Content

options/admin/yp/reset

Localhost port 8080

http://localhost:8080/api/admin/yp/reset

GetVideoPlaybackMetricsOptions

Responses

204

No Content

options/admin/metrics/video

Localhost port 8080

http://localhost:8080/api/admin/metrics/video

SendFederatedMessageOptions

Responses

204

No Content

options/admin/federation/send

Localhost port 8080

http://localhost:8080/api/admin/federation/send

GetFederatedActionsOptions

Responses

204

No Content

options/admin/federation/actions

Localhost port 8080

http://localhost:8080/api/admin/federation/actions

SendSystemMessageOptions

Responses

204

No Content

options/integrations/chat/system

Localhost port 8080

http://localhost:8080/api/integrations/chat/system

SendSystemMessageToConnectedClientOptions

path Parameters

| clientId required |

integer

The ID of the specified client

|

Responses

204

No Content

options/integrations/chat/system/client/{clientId}

Localhost port 8080

http://localhost:8080/api/integrations/chat/system/client/{clientId}

SendUserMessageOptions Deprecated

Responses

204

No Content

options/integrations/chat/user

Localhost port 8080

http://localhost:8080/api/integrations/chat/user

SendIntegrationChatMessageOptions

Responses

204

No Content

options/integrations/chat/send

Localhost port 8080

http://localhost:8080/api/integrations/chat/send

SendChatActionOptions

Responses

204

No Content

options/integrations/chat/action

Localhost port 8080

http://localhost:8080/api/integrations/chat/action

ExternalUpdateMessageVisibilityOptions

Responses

204

No Content

options/integrations/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/integrations/chat/messagevisibility

ExternalSetStreamTitleOptions

Responses

204

No Content

options/integrations/streamtitle

Localhost port 8080

http://localhost:8080/api/integrations/streamtitle

ExternalGetChatMessagesOptions

Responses

204

No Content

options/integrations/chat

Localhost port 8080

http://localhost:8080/api/integrations/chat

ExternalGetConnectedChatClientsOptions

Responses

204

No Content

options/integrations/clients

Localhost port 8080

http://localhost:8080/api/integrations/clients

Video

Video API

Get a list of video variants available

Responses

200

List of available video variants

get/video/variants

Localhost port 8080

http://localhost:8080/api/video/variants

Response samples

  • 200

Content type application/json

Copy Expand all Collapse all

`[ {

"index": 0,

"name": "string"

}

]`

Tell the backend you're an active viewer

Responses

200

Added as an active viewer

get/ping

Localhost port 8080

http://localhost:8080/api/ping

Disconnect inbound stream

Authorizations:

BasicAuth

Responses

200

Contains information about disconnection status

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/disconnect

Localhost port 8080

http://localhost:8080/api/admin/disconnect

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

DisconnectInboundConnectionOptions

Responses

204

No Content

options/admin/disconnect

Localhost port 8080

http://localhost:8080/api/admin/disconnect

GetActiveViewersOptions

Responses

204

No Content

options/admin/viewers

Localhost port 8080

http://localhost:8080/api/admin/viewers

Set video codec

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Video codec updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/video/codec

Localhost port 8080

http://localhost:8080/api/admin/config/video/codec

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetVideoCodecOptions

Responses

204

No Content

options/admin/config/video/codec

Localhost port 8080

http://localhost:8080/api/admin/config/video/codec

Set the number of video segments and duration per segment in a playlist

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Stream latency updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/video/streamlatencylevel

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamlatencylevel

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetStreamLatencyLevelOptions

Responses

204

No Content

options/admin/config/video/streamlatencylevel

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamlatencylevel

Set an array of video output configurations

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of objects (StreamOutputVariant)

|

Responses

200

Stream Output Variants updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/video/streamoutputvariants

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamoutputvariants

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": [ {

"name": "string",

"videoPassthrough": true,

"audioPassthrough": true,

"videoBitrate": 0,

"audioBitrate": 0,

"scaledWidth": 0,

"scaledHeight": 0,

"framerate": 0,

"cpuUsageLevel": 0

}

]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetStreamOutputVariantsOptions

Responses

204

No Content

options/admin/config/video/streamoutputvariants

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamoutputvariants

Update RTMP post

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

RTMP port updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/rtmpserverport

Localhost port 8080

http://localhost:8080/api/admin/config/rtmpserverport

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetRTMPServerPortOptions

Responses

204

No Content

options/admin/config/rtmpserverport

Localhost port 8080

http://localhost:8080/api/admin/config/rtmpserverport

Update custom video serving endpoint

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Video Serving Endpoint updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/videoservingendpoint

Localhost port 8080

http://localhost:8080/api/admin/config/videoservingendpoint

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetVideoServingEndpointOptions

Responses

204

No Content

options/admin/config/videoservingendpoint

Localhost port 8080

http://localhost:8080/api/admin/config/videoservingendpoint

Update S3 configuration

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object (S3Info)

|

Responses

200

Directory Enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/s3

Localhost port 8080

http://localhost:8080/api/admin/config/s3

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"endpoint": "string",

"accessKey": "string",

"secret": "string",

"bucket": "string",

"region": "string",

"acl": "string",

"pathPrefix": "string",

"enabled": true,

"forcePathStyle": true

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetS3ConfigurationOptions

Responses

204

No Content

options/admin/config/s3

Localhost port 8080

http://localhost:8080/api/admin/config/s3

Get video playback metrics

Authorizations:

BasicAuth

Responses

200

Video playback metrics

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/metrics/video

Localhost port 8080

http://localhost:8080/api/admin/metrics/video

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"errors": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"qualityVariantChanges": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"highestLatency": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"medianLatency": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"lowestLatency": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"medianSegmentDownloadDuration": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"maximumSegmentDownloadDuration": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"minimumSegmentDownloadDuration": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"minPlayerBitrate": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"medianPlayerBitrate": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"maxPlayerBitrate": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"availableBitrates": [0 ],

"segmentLength": 0,

"representation": 0

}`

GetVideoPlaybackMetricsOptions

Responses

204

No Content

options/admin/metrics/video

Localhost port 8080

http://localhost:8080/api/admin/metrics/video

Notifications

Notification API

Configure Discord notifications

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object (DiscordNotificationConfiguration)

|

Responses

200

Discord notification configuration updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/notifications/discord

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/discord

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"webhook": "string",

"goLiveMessage": "string",

"enabled": true

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetDiscordNotificationConfigurationOptions

Responses

204

No Content

options/admin/config/notifications/discord

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/discord

Configure Browser notifications

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object (BrowserNotificationConfiguration)

|

Responses

200

Browser notification configuration updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/notifications/browser

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/browser

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"goLiveMessage": "string",

"enabled": true

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetBrowserNotificationConfigurationOptions

Responses

204

No Content

options/admin/config/notifications/browser

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/browser

Get all the webhooks

Authorizations:

BasicAuth

Responses

200

All webhooks

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/webhooks

Localhost port 8080

http://localhost:8080/api/admin/webhooks

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"timestamp": "2019-08-24T14:15:22Z",

"lastUsed": "2019-08-24T14:15:22Z",

"url": "string",

"events": ["CHAT" ],

"id": 0

}

]`

GetWebhooksOptions

Responses

204

No Content

options/admin/webhooks

Localhost port 8080

http://localhost:8080/api/admin/webhooks

Delete a single webhook

Authorizations:

BasicAuth

Request Body schema: application/json

| id |

integer

|

Responses

200

Webhook successfully deleted

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/webhooks/delete

Localhost port 8080

http://localhost:8080/api/admin/webhooks/delete

Request samples

  • Payload

Content type application/json

Copy

`{ "id": 0

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

DeleteWebhookOptions

Responses

204

No Content

options/admin/webhooks/delete

Localhost port 8080

http://localhost:8080/api/admin/webhooks/delete

Create a single webhook

Authorizations:

BasicAuth

Request Body schema: application/json

| url |

string

| | events |

Array of strings (WebhookEventType)

Items Enum: "CHAT" "USER_JOINED" "USER_PARTED" "NAME_CHANGE" "VISIBILITY-UPDATE" "PING" "PONG" "STREAM_STARTED" "STREAM_STOPPED" "STREAM_TITLE_UPDATED" "SYSTEM" "CHAT_ACTION"

|

Responses

200

The new webhook

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/webhooks/create

Localhost port 8080

http://localhost:8080/api/admin/webhooks/create

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"url": "string",

"events": ["CHAT" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"timestamp": "2019-08-24T14:15:22Z",

"lastUsed": "2019-08-24T14:15:22Z",

"url": "string",

"events": ["CHAT" ],

"id": 0

}`

CreateWebhookOptions

Responses

204

No Content

options/admin/webhooks/create

Localhost port 8080

http://localhost:8080/api/admin/webhooks/create

Social

Social API

Request remote follow

Request Body schema: application/json

| account |

string

|

Responses

200

Contains redirect URL remote follow follow

400

Bad request

post/remotefollow

Localhost port 8080

http://localhost:8080/api/remotefollow

Request samples

  • Payload

Content type application/json

Copy

`{ "account": "string"

}`

Response samples

  • 200
  • 400

Content type application/json

Copy

`{ "redirectUrl": "string"

}`

Gets the list of followers

query Parameters

| offset |

integer

The number of items to skip before starting to collect the result set

| | limit |

integer

The numbers of items to return

|

Responses

200

Paginated follower count

400

Bad request

get/followers

Localhost port 8080

http://localhost:8080/api/followers

Response samples

  • 200
  • 400

Content type application/json

Copy Expand all Collapse all

`{

"total": 0,

"results": [ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]

}`

Get followers

Authorizations:

BasicAuth

query Parameters

| offset |

integer

The number of items to skip before starting to collect the result set

| | limit |

integer

The numbers of items to return

|

Responses

200

Paginated follower count

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/followers

Localhost port 8080

http://localhost:8080/api/admin/followers

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"total": 0,

"results": [ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]

}`

Get a list of pending follow requests

Authorizations:

BasicAuth

Responses

200

List of pending followers

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/followers/pending

Localhost port 8080

http://localhost:8080/api/admin/followers/pending

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]`

GetPendingFollowRequestsOptions

Responses

204

No Content

options/admin/followers/pending

Localhost port 8080

http://localhost:8080/api/admin/followers/pending

Get a list of rejected or blocked follows

Authorizations:

BasicAuth

Responses

200

List of rejected or blocked follows

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/followers/blocked

Localhost port 8080

http://localhost:8080/api/admin/followers/blocked

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]`

GetBlockedAndRejectedFollowersOptions

Responses

204

No Content

options/admin/followers/blocked

Localhost port 8080

http://localhost:8080/api/admin/followers/blocked

Set the following state of a follower or follow request

Authorizations:

BasicAuth

Request Body schema: application/json

| actorIRI |

string

| | approved |

boolean

|

Responses

200

List of rejected or blocked follows

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/followers/approve

Localhost port 8080

http://localhost:8080/api/admin/followers/approve

Request samples

  • Payload

Content type application/json

Copy

`{

"actorIRI": "string",

"approved": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

ApproveFollowerOptions

Responses

204

No Content

options/admin/followers/approve

Localhost port 8080

http://localhost:8080/api/admin/followers/approve

Enable/disable federation features

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation features enabled/disabled

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/enable

Localhost port 8080

http://localhost:8080/api/admin/config/federation/enable

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationEnabledOptions

Responses

204

No Content

options/admin/config/federation/enable

Localhost port 8080

http://localhost:8080/api/admin/config/federation/enable

Set if federation activities are private

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Private status set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/private

Localhost port 8080

http://localhost:8080/api/admin/config/federation/private

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationActivityPrivateOptions

Responses

204

No Content

options/admin/config/federation/private

Localhost port 8080

http://localhost:8080/api/admin/config/federation/private

Set if fediverse engagement appears in chat

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation engagement set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/showengagement

Localhost port 8080

http://localhost:8080/api/admin/config/federation/showengagement

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationShowEngagementOptions

Responses

204

No Content

options/admin/config/federation/showengagement

Localhost port 8080

http://localhost:8080/api/admin/config/federation/showengagement

Set local federated username

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation username set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/username

Localhost port 8080

http://localhost:8080/api/admin/config/federation/username

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationUsernameOptions

Responses

204

No Content

options/admin/config/federation/username

Localhost port 8080

http://localhost:8080/api/admin/config/federation/username

Set federated go live message

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation username set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/livemessage

Localhost port 8080

http://localhost:8080/api/admin/config/federation/livemessage

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationGoLiveMessageOptions

Responses

204

No Content

options/admin/config/federation/livemessage

Localhost port 8080

http://localhost:8080/api/admin/config/federation/livemessage

Set Federation blocked domains

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation blocked domains set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/blockdomains

Localhost port 8080

http://localhost:8080/api/admin/config/federation/blockdomains

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationBlockDomainsOptions

Responses

204

No Content

options/admin/config/federation/blockdomains

Localhost port 8080

http://localhost:8080/api/admin/config/federation/blockdomains

Send a public message to the Fediverse from the server's user

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Message sent

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/federation/send

Localhost port 8080

http://localhost:8080/api/admin/federation/send

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SendFederatedMessageOptions

Responses

204

No Content

options/admin/federation/send

Localhost port 8080

http://localhost:8080/api/admin/federation/send

Get a paginated list of federated activities

Authorizations:

BasicAuth

query Parameters

| offset |

integer

The number of items to skip before starting to collect the result set

| | limit |

integer

The numbers of items to return

|

Responses

200

A paginated list of federated activities

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/federation/actions

Localhost port 8080

http://localhost:8080/api/admin/federation/actions

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"total": 0,

"results": {

"timestamp": "2019-08-24T14:15:22Z",

"iri": "string",

"actorIRI": "string",

"type": "string"

}

}`

GetFederatedActionsOptions

Responses

204

No Content

options/admin/federation/actions

Localhost port 8080

http://localhost:8080/api/admin/federation/actions

Admin

Get current inboard broadcaster

Authorizations:

BasicAuth

Responses

200

Gives the status of the system

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/status

Localhost port 8080

http://localhost:8080/api/admin/status

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"broadcaster": {

"time": "2019-08-24T14:15:22Z",

"remoteAddr": "string",

"streamDetails": {

"videoCodec": "string",

"audioCodec": "string",

"encoder": "string",

"width": 0,

"height": 0,

"videoBitrate": 0,

"audioBitrate": 0,

"framerate": 0.1

}

},

"currentBroadcast": {

"outputSettings": [ {

"name": "string",

"videoPassthrough": true,

"audioPassthrough": true,

"videoBitrate": 0,

"audioBitrate": 0,

"scaledWidth": 0,

"scaledHeight": 0,

"framerate": 0,

"cpuUsageLevel": 0

}

],

"latencyLevel": { "level": 0

}

},

"health": {

"message": "string",

"healthPercentage": 0,

"representation": 0,

"healthy": true

},

"streamTitle": "string",

"versionNumber": "string",

"viewerCount": 0,

"overallPeakViewerCount": 0,

"sessionPeakViewerCount": 0,

"online": true

}`

Disconnect inbound stream

Authorizations:

BasicAuth

Responses

200

Contains information about disconnection status

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/disconnect

Localhost port 8080

http://localhost:8080/api/admin/disconnect

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get the current server config

Authorizations:

BasicAuth

Responses

200

Current server config

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/serverconfig

Localhost port 8080

http://localhost:8080/api/admin/serverconfig

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"instanceDetails": {

"appearanceVariables": {

"property1": "string",

"property2": "string"

},

"version": "string",

"welcomeMessage": "string",

"offlineMessage": "string",

"logo": "string",

"name": "string",

"extraPageContent": "string",

"streamTitle": "string",

"customStyles": "string",

"customJavascript": "string",

"summary": "string",

"tags": ["string" ],

"socialHandles": [ {

"platform": "string",

"url": "string",

"icon": "string"

}

],

"nsfw": true

},

"notifications": {

"browser": {

"goLiveMessage": "string",

"enabled": true

},

"discord": {

"webhook": "string",

"goLiveMessage": "string",

"enabled": true

}

},

"yp": {

"instanceUrl": "string",

"enabled": true

},

"ffmpegPath": "string",

"adminPassword": "string",

"socketHostOverride": "string",

"webServerIP": "string",

"videoCodec": "string",

"videoServingEndpoint": "string",

"s3": {

"endpoint": "string",

"accessKey": "string",

"secret": "string",

"bucket": "string",

"region": "string",

"acl": "string",

"pathPrefix": "string",

"enabled": true,

"forcePathStyle": true

},

"federation": {

"username": "string",

"goLiveMessage": "string",

"blockedDomains": ["string" ],

"enabled": true,

"isPrivate": true,

"showEngagement": true

},

"supportedCodecs": ["string" ],

"externalActions": [ {

"url": "string",

"html": "string",

"title": "string",

"description": "string",

"icon": "string",

"color": "string",

"openExternally": true

}

],

"forbiddenUsernames": ["string" ],

"suggestedUsernames": ["string" ],

"streamKeys": [ {

"key": "string",

"comment": "string"

}

],

"videoSettings": {

"videoQualityVariants": [ {

"name": "string",

"videoPassthrough": true,

"audioPassthrough": true,

"videoBitrate": 0,

"audioBitrate": 0,

"scaledWidth": 0,

"scaledHeight": 0,

"framerate": 0,

"cpuUsageLevel": 0

}

],

"latencyLevel": 0

},

"rtmpServerPort": 0,

"webServerPort": 0,

"chatDisabled": true,

"chatJoinMessagesEnabled": true,

"chatEstablishedUserMode": true,

"disableSearchIndexing": true,

"streamKeyOverridden": true,

"hideViewerCount": true

}`

Get viewer count over time

Authorizations:

BasicAuth

query Parameters

| windowStart |

string

Start date in unix time

|

Responses

200

Viewer count over time

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/viewersOverTime

Localhost port 8080

http://localhost:8080/api/admin/viewersOverTime

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

]`

Get active viewers

Authorizations:

BasicAuth

Responses

200

List of active viewers

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/viewers

Localhost port 8080

http://localhost:8080/api/admin/viewers

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"firstSeen": "2019-08-24T14:15:22Z",

"geo": {

"countryCode": "string",

"regionName": "string",

"timeZone": "string"

},

"userAgent": "string",

"ipAddress": "string",

"clientID": "string"

}

]`

Get the current hardware stats

Authorizations:

BasicAuth

Responses

200

Current hardware stats

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/hardwarestats

Localhost port 8080

http://localhost:8080/api/admin/hardwarestats

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"message": "string",

"healthPercentage": 0,

"representation": 0,

"healthy": true,

"disk": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"memory": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"cpu": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

]

}`

Get a detailed list of currently connected chat clients

Authorizations:

BasicAuth

Responses

200

List of chat clients

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/clients

Localhost port 8080

http://localhost:8080/api/admin/chat/clients

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"connectedAt": "2019-08-24T14:15:22Z",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"geo": {

"countryCode": "string",

"regionName": "string",

"timeZone": "string"

},

"userAgent": "string",

"messageCount": 0

}

]`

Get all chat messages for the admin, unfiltered

Authorizations:

BasicAuth

Responses

200

List of chat messages for the admin

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/messages

Localhost port 8080

http://localhost:8080/api/admin/chat/messages

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"timestamp": "string",

"type": "string",

"id": "string",

"user": {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

},

"hiddenAt": "string",

"clientId": 0,

"body": "string"

}

]`

Update visibility of chat messages

Authorizations:

BasicAuth

Request Body schema: application/json

| idArray |

Array of strings

| | visible |

boolean

|

Responses

200

Messages updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/admin/chat/messagevisibility

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"idArray": ["string" ],

"visible": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Enable or disable a user

Authorizations:

BasicAuth

Request Body schema: application/json

| userId |

string

| | enabled |

boolean

|

Responses

200

Successfully updated the user

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/setenabled

Localhost port 8080

http://localhost:8080/api/admin/chat/users/setenabled

Request samples

  • Payload

Content type application/json

Copy

`{

"userId": "string",

"enabled": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get a list of disabled users

Authorizations:

BasicAuth

Responses

200

List of disabled users

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/users/disabled

Localhost port 8080

http://localhost:8080/api/admin/chat/users/disabled

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

}

]`

Ban an IP address

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

IP was successfully banned

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/ipbans/create

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans/create

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Remove an IP ban

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

string or boolean or Array of strings or number

|

Responses

200

IP ban was successfully removed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/ipbans/remove

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans/remove

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get all banned IP addresses

Authorizations:

BasicAuth

Responses

200

List of banned IP addresses

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/users/ipbans

Localhost port 8080

http://localhost:8080/api/admin/chat/users/ipbans

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "2019-08-24T14:15:22Z",

"ipAddress": "string",

"notes": "string"

}

]`

Set moderator status for a user

Authorizations:

BasicAuth

Request Body schema: application/json

| userId |

string

| | isModerator |

boolean

|

Responses

200

Successfully update the moderator status of the user

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/chat/users/setmoderator

Localhost port 8080

http://localhost:8080/api/admin/chat/users/setmoderator

Request samples

  • Payload

Content type application/json

Copy

`{

"userId": "string",

"isModerator": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Get a list of moderator users

Authorizations:

BasicAuth

Responses

200

List of moderator users

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/chat/users/moderators

Localhost port 8080

http://localhost:8080/api/admin/chat/users/moderators

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "string",

"disabledAt": "string",

"nameChangedAt": "string",

"id": "string",

"displayName": "string",

"previousNames": ["string" ],

"scopes": ["string" ],

"displayColor": 0,

"isBot": true,

"authenticated": true

}

]`

GetModeratorsOptions

Responses

204

No Content

options/admin/chat/users/moderators

Localhost port 8080

http://localhost:8080/api/admin/chat/users/moderators

Get all logs

Authorizations:

BasicAuth

Responses

200

List of logs

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/logs

Localhost port 8080

http://localhost:8080/api/admin/logs

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"time": "2019-08-24T14:15:22Z",

"message": "string",

"level": "string"

}

]`

GetLogsOptions

Responses

204

No Content

options/admin/logs

Localhost port 8080

http://localhost:8080/api/admin/logs

Get warning/error logs

Authorizations:

BasicAuth

Responses

200

List of warnings and errors

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/logs/warnings

Localhost port 8080

http://localhost:8080/api/admin/logs/warnings

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"time": "2019-08-24T14:15:22Z",

"message": "string",

"level": "string"

}

]`

GetWarningsOptions

Responses

204

No Content

options/admin/logs/warnings

Localhost port 8080

http://localhost:8080/api/admin/logs/warnings

Get followers

Authorizations:

BasicAuth

query Parameters

| offset |

integer

The number of items to skip before starting to collect the result set

| | limit |

integer

The numbers of items to return

|

Responses

200

Paginated follower count

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/followers

Localhost port 8080

http://localhost:8080/api/admin/followers

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"total": 0,

"results": [ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]

}`

GetFollowersAdminOptions

Responses

204

No Content

options/admin/followers

Localhost port 8080

http://localhost:8080/api/admin/followers

Get a list of pending follow requests

Authorizations:

BasicAuth

Responses

200

List of pending followers

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/followers/pending

Localhost port 8080

http://localhost:8080/api/admin/followers/pending

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]`

GetPendingFollowRequestsOptions

Responses

204

No Content

options/admin/followers/pending

Localhost port 8080

http://localhost:8080/api/admin/followers/pending

Get a list of rejected or blocked follows

Authorizations:

BasicAuth

Responses

200

List of rejected or blocked follows

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/followers/blocked

Localhost port 8080

http://localhost:8080/api/admin/followers/blocked

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"link": "string",

"name": "string",

"username": "string",

"image": "string",

"timestamp": "string",

"disabledAt": "string"

}

]`

GetBlockedAndRejectedFollowersOptions

Responses

204

No Content

options/admin/followers/blocked

Localhost port 8080

http://localhost:8080/api/admin/followers/blocked

Set the following state of a follower or follow request

Authorizations:

BasicAuth

Request Body schema: application/json

| actorIRI |

string

| | approved |

boolean

|

Responses

200

List of rejected or blocked follows

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/followers/approve

Localhost port 8080

http://localhost:8080/api/admin/followers/approve

Request samples

  • Payload

Content type application/json

Copy

`{

"actorIRI": "string",

"approved": true

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

ApproveFollowerOptions

Responses

204

No Content

options/admin/followers/approve

Localhost port 8080

http://localhost:8080/api/admin/followers/approve

Upload custom emoji

Authorizations:

BasicAuth

Request Body schema: application/json

| name |

string

| | data |

string

Base 64 encoded image data

|

Responses

200

Emoji has been uploaded

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/emoji/upload

Localhost port 8080

http://localhost:8080/api/admin/emoji/upload

Request samples

  • Payload

Content type application/json

Copy

`{

"name": "string",

"data": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

UploadCustomEmojiOptions

Responses

204

No Content

options/admin/emoji/upload

Localhost port 8080

http://localhost:8080/api/admin/emoji/upload

Delete custom emoji

Authorizations:

BasicAuth

Request Body schema: application/json

| name |

string

|

Responses

200

Emoji has been deleted

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/emoji/delete

Localhost port 8080

http://localhost:8080/api/admin/emoji/delete

Request samples

  • Payload

Content type application/json

Copy

`{ "name": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

DeleteCustomEmojiOptions

Responses

204

No Content

options/admin/emoji/delete

Localhost port 8080

http://localhost:8080/api/admin/emoji/delete

Change the current admin password

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Admin password has been updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/adminpass

Localhost port 8080

http://localhost:8080/api/admin/config/adminpass

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetAdminPasswordOptions

Responses

204

No Content

options/admin/config/adminpass

Localhost port 8080

http://localhost:8080/api/admin/config/adminpass

Set an array of valid stream keys

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of objects (StreamKey)

|

Responses

200

Stream keys have been updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/streamkeys

Localhost port 8080

http://localhost:8080/api/admin/config/streamkeys

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": [ {

"key": "string",

"comment": "string"

}

]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetStreamKeysOptions

Responses

204

No Content

options/admin/config/streamkeys

Localhost port 8080

http://localhost:8080/api/admin/config/streamkeys

Change the extra page content in memory

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Page content has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/pagecontent

Localhost port 8080

http://localhost:8080/api/admin/config/pagecontent

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetExtraPageContentOptions

Responses

204

No Content

options/admin/config/pagecontent

Localhost port 8080

http://localhost:8080/api/admin/config/pagecontent

Change the stream title

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Stream title has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/streamtitle

Localhost port 8080

http://localhost:8080/api/admin/config/streamtitle

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetStreamTitleOptions

Responses

204

No Content

options/admin/config/streamtitle

Localhost port 8080

http://localhost:8080/api/admin/config/streamtitle

Change the server name

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Server name has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/name

Localhost port 8080

http://localhost:8080/api/admin/config/name

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerNameOptions

Responses

204

No Content

options/admin/config/name

Localhost port 8080

http://localhost:8080/api/admin/config/name

Change the server summary

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Server summary has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/serversummary

Localhost port 8080

http://localhost:8080/api/admin/config/serversummary

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerSummaryOptions

Responses

204

No Content

options/admin/config/serversummary

Localhost port 8080

http://localhost:8080/api/admin/config/serversummary

Change the offline message

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Offline message has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/offlinemessage

Localhost port 8080

http://localhost:8080/api/admin/config/offlinemessage

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetCustomOfflineMessageOptions

Responses

204

No Content

options/admin/config/offlinemessage

Localhost port 8080

http://localhost:8080/api/admin/config/offlinemessage

Change the welcome message

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Welcome message has been changed

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/welcomemessage

Localhost port 8080

http://localhost:8080/api/admin/config/welcomemessage

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerWelcomeMessageOptions

Responses

204

No Content

options/admin/config/welcomemessage

Localhost port 8080

http://localhost:8080/api/admin/config/welcomemessage

Disable chat

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Chat has been disabled

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/disable

Localhost port 8080

http://localhost:8080/api/admin/config/chat/disable

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatDisabledOptions

Responses

204

No Content

options/admin/config/chat/disable

Localhost port 8080

http://localhost:8080/api/admin/config/chat/disable

Enable chat for user join messages

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

User join messages has been enabled

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/joinmessagesenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/joinmessagesenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatJoinMessagesEnabledOptions

Responses

204

No Content

options/admin/config/chat/joinmessagesenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/joinmessagesenabled

Enable/disable chat established user mode

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Chat established user mode updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/establishedusermode

Localhost port 8080

http://localhost:8080/api/admin/config/chat/establishedusermode

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetEnableEstablishedChatUserModeOptions

Responses

204

No Content

options/admin/config/chat/establishedusermode

Localhost port 8080

http://localhost:8080/api/admin/config/chat/establishedusermode

Set chat usernames that are not allowed

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of strings

|

Responses

200

Forbidden usernames updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/forbiddenusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/forbiddenusernames

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": ["string" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetForbiddenUsernameListOptions

Responses

204

No Content

options/admin/config/chat/forbiddenusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/forbiddenusernames

Set the suggested chat usernames that will be assigned automatically

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of strings

|

Responses

200

Suggested usernames updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/suggestedusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/suggestedusernames

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": ["string" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetSuggestedUsernameListOptions

Responses

204

No Content

options/admin/config/chat/suggestedusernames

Localhost port 8080

http://localhost:8080/api/admin/config/chat/suggestedusernames

Set spam protection enabled

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Spam protection enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/spamprotectionenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/spamprotectionenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatSpamProtectionEnabledOptions

Responses

204

No Content

options/admin/config/chat/spamprotectionenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/spamprotectionenabled

Set slur filter enabled

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Slur filter enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/slurfilterenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/slurfilterenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatSlurFilterEnabledOptions

Responses

204

No Content

options/admin/config/chat/slurfilterenabled

Localhost port 8080

http://localhost:8080/api/admin/config/chat/slurfilterenabled

Set require authentication for chat

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Require authentication setting updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/chat/requireauthentication

Localhost port 8080

http://localhost:8080/api/admin/config/chat/requireauthentication

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetChatRequireAuthenticationOptions

Responses

204

No Content

options/admin/config/chat/requireauthentication

Localhost port 8080

http://localhost:8080/api/admin/config/chat/requireauthentication

Set video codec

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Video codec updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/video/codec

Localhost port 8080

http://localhost:8080/api/admin/config/video/codec

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetVideoCodecOptions

Responses

204

No Content

options/admin/config/video/codec

Localhost port 8080

http://localhost:8080/api/admin/config/video/codec

Set the number of video segments and duration per segment in a playlist

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Stream latency updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/video/streamlatencylevel

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamlatencylevel

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetStreamLatencyLevelOptions

Responses

204

No Content

options/admin/config/video/streamlatencylevel

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamlatencylevel

Set an array of video output configurations

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of objects (StreamOutputVariant)

|

Responses

200

Stream Output Variants updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/video/streamoutputvariants

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamoutputvariants

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": [ {

"name": "string",

"videoPassthrough": true,

"audioPassthrough": true,

"videoBitrate": 0,

"audioBitrate": 0,

"scaledWidth": 0,

"scaledHeight": 0,

"framerate": 0,

"cpuUsageLevel": 0

}

]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetStreamOutputVariantsOptions

Responses

204

No Content

options/admin/config/video/streamoutputvariants

Localhost port 8080

http://localhost:8080/api/admin/config/video/streamoutputvariants

Set style/color/css values

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object

|

Responses

200

Appearance updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/appearance

Localhost port 8080

http://localhost:8080/api/admin/config/appearance

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"property1": "string",

"property2": "string"

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetCustomColorVariableValuesOptions

Responses

204

No Content

options/admin/config/appearance

Localhost port 8080

http://localhost:8080/api/admin/config/appearance

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Logo updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/logo

Localhost port 8080

http://localhost:8080/api/admin/config/logo

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetLogoOptions

Responses

204

No Content

options/admin/config/logo

Localhost port 8080

http://localhost:8080/api/admin/config/logo

Upload custom favicon

Authorizations:

BasicAuth

Request Body schema: multipart/form-data

| favicon |

string <binary>

Favicon file (PNG or ICO, max 200KB)

|

Responses

200

Favicon updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/favicon

Localhost port 8080

http://localhost:8080/api/admin/config/favicon

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

Reset favicon to default

Authorizations:

BasicAuth

Responses

200

Favicon reset to default

401

Basic auth failure

default

Unexpected error

delete/admin/config/favicon

Localhost port 8080

http://localhost:8080/api/admin/config/favicon

Response samples

  • 200
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFaviconOptions

Responses

204

No Content

options/admin/config/favicon

Localhost port 8080

http://localhost:8080/api/admin/config/favicon

Update server tags

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Tags updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/tags

Localhost port 8080

http://localhost:8080/api/admin/config/tags

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetTagsOptions

Responses

204

No Content

options/admin/config/tags

Localhost port 8080

http://localhost:8080/api/admin/config/tags

Update FFMPEG path

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Path updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/ffmpegpath

Localhost port 8080

http://localhost:8080/api/admin/config/ffmpegpath

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFfmpegPathOptions

Responses

204

No Content

options/admin/config/ffmpegpath

Localhost port 8080

http://localhost:8080/api/admin/config/ffmpegpath

Update server port

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Port updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/webserverport

Localhost port 8080

http://localhost:8080/api/admin/config/webserverport

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetWebServerPortOptions

Responses

204

No Content

options/admin/config/webserverport

Localhost port 8080

http://localhost:8080/api/admin/config/webserverport

Update server IP address

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

IP Address updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/webserverip

Localhost port 8080

http://localhost:8080/api/admin/config/webserverip

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetWebServerIPOptions

Responses

204

No Content

options/admin/config/webserverip

Localhost port 8080

http://localhost:8080/api/admin/config/webserverip

Update RTMP post

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

RTMP port updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/rtmpserverport

Localhost port 8080

http://localhost:8080/api/admin/config/rtmpserverport

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetRTMPServerPortOptions

Responses

204

No Content

options/admin/config/rtmpserverport

Localhost port 8080

http://localhost:8080/api/admin/config/rtmpserverport

Update websocket host override

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Websocket host override updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/sockethostoverride

Localhost port 8080

http://localhost:8080/api/admin/config/sockethostoverride

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetSocketHostOverrideOptions

Responses

204

No Content

options/admin/config/sockethostoverride

Localhost port 8080

http://localhost:8080/api/admin/config/sockethostoverride

Update custom video serving endpoint

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Video Serving Endpoint updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/videoservingendpoint

Localhost port 8080

http://localhost:8080/api/admin/config/videoservingendpoint

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetVideoServingEndpointOptions

Responses

204

No Content

options/admin/config/videoservingendpoint

Localhost port 8080

http://localhost:8080/api/admin/config/videoservingendpoint

Update NSFW marking

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

NSFW status updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/nsfw

Localhost port 8080

http://localhost:8080/api/admin/config/nsfw

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetNSFWOptions

Responses

204

No Content

options/admin/config/nsfw

Localhost port 8080

http://localhost:8080/api/admin/config/nsfw

Update directory enabled

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Directory Enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/directoryenabled

Localhost port 8080

http://localhost:8080/api/admin/config/directoryenabled

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetDirectoryEnabledOptions

Responses

204

No Content

options/admin/config/directoryenabled

Localhost port 8080

http://localhost:8080/api/admin/config/directoryenabled

Update social handles

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of objects (SocialHandle)

|

Responses

200

Social handles updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/socialhandles

Localhost port 8080

http://localhost:8080/api/admin/config/socialhandles

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": [ {

"platform": "string",

"url": "string",

"icon": "string"

}

]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetSocialHandlesOptions

Responses

204

No Content

options/admin/config/socialhandles

Localhost port 8080

http://localhost:8080/api/admin/config/socialhandles

Update S3 configuration

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object (S3Info)

|

Responses

200

Directory Enabled updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/s3

Localhost port 8080

http://localhost:8080/api/admin/config/s3

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"endpoint": "string",

"accessKey": "string",

"secret": "string",

"bucket": "string",

"region": "string",

"acl": "string",

"pathPrefix": "string",

"enabled": true,

"forcePathStyle": true

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetS3ConfigurationOptions

Responses

204

No Content

options/admin/config/s3

Localhost port 8080

http://localhost:8080/api/admin/config/s3

Update server url

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Server URL updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/serverurl

Localhost port 8080

http://localhost:8080/api/admin/config/serverurl

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetServerURLOptions

Responses

204

No Content

options/admin/config/serverurl

Localhost port 8080

http://localhost:8080/api/admin/config/serverurl

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

Array of objects (ExternalAction)

|

Responses

200

External Action Links updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/externalactions

Localhost port 8080

http://localhost:8080/api/admin/config/externalactions

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": [ {

"url": "string",

"html": "string",

"title": "string",

"description": "string",

"icon": "string",

"color": "string",

"openExternally": true

}

]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetExternalActionsOptions

Responses

204

No Content

options/admin/config/externalactions

Localhost port 8080

http://localhost:8080/api/admin/config/externalactions

Update custom styles

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Custom styles updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/customstyles

Localhost port 8080

http://localhost:8080/api/admin/config/customstyles

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetCustomStylesOptions

Responses

204

No Content

options/admin/config/customstyles

Localhost port 8080

http://localhost:8080/api/admin/config/customstyles

Update custom JavaScript

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Custom JavaScript updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/customjavascript

Localhost port 8080

http://localhost:8080/api/admin/config/customjavascript

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetCustomJavascriptOptions

Responses

204

No Content

options/admin/config/customjavascript

Localhost port 8080

http://localhost:8080/api/admin/config/customjavascript

Update hide viewer count

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Hide viewer count updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/hideviewercount

Localhost port 8080

http://localhost:8080/api/admin/config/hideviewercount

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetHideViewerCountOptions

Responses

204

No Content

options/admin/config/hideviewercount

Localhost port 8080

http://localhost:8080/api/admin/config/hideviewercount

Update search indexing

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Search Indexing updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/disablesearchindexing

Localhost port 8080

http://localhost:8080/api/admin/config/disablesearchindexing

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetDisableSearchIndexingOptions

Responses

204

No Content

options/admin/config/disablesearchindexing

Localhost port 8080

http://localhost:8080/api/admin/config/disablesearchindexing

Enable/disable federation features

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation features enabled/disabled

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/enable

Localhost port 8080

http://localhost:8080/api/admin/config/federation/enable

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationEnabledOptions

Responses

204

No Content

options/admin/config/federation/enable

Localhost port 8080

http://localhost:8080/api/admin/config/federation/enable

Set if federation activities are private

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Private status set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/private

Localhost port 8080

http://localhost:8080/api/admin/config/federation/private

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationActivityPrivateOptions

Responses

204

No Content

options/admin/config/federation/private

Localhost port 8080

http://localhost:8080/api/admin/config/federation/private

Set if fediverse engagement appears in chat

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation engagement set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/showengagement

Localhost port 8080

http://localhost:8080/api/admin/config/federation/showengagement

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationShowEngagementOptions

Responses

204

No Content

options/admin/config/federation/showengagement

Localhost port 8080

http://localhost:8080/api/admin/config/federation/showengagement

Set local federated username

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation username set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/username

Localhost port 8080

http://localhost:8080/api/admin/config/federation/username

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationUsernameOptions

Responses

204

No Content

options/admin/config/federation/username

Localhost port 8080

http://localhost:8080/api/admin/config/federation/username

Set federated go live message

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation username set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/livemessage

Localhost port 8080

http://localhost:8080/api/admin/config/federation/livemessage

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationGoLiveMessageOptions

Responses

204

No Content

options/admin/config/federation/livemessage

Localhost port 8080

http://localhost:8080/api/admin/config/federation/livemessage

Set Federation blocked domains

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Federation blocked domains set

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/federation/blockdomains

Localhost port 8080

http://localhost:8080/api/admin/config/federation/blockdomains

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetFederationBlockDomainsOptions

Responses

204

No Content

options/admin/config/federation/blockdomains

Localhost port 8080

http://localhost:8080/api/admin/config/federation/blockdomains

Configure Discord notifications

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object (DiscordNotificationConfiguration)

|

Responses

200

Discord notification configuration updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/notifications/discord

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/discord

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"webhook": "string",

"goLiveMessage": "string",

"enabled": true

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetDiscordNotificationConfigurationOptions

Responses

204

No Content

options/admin/config/notifications/discord

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/discord

Configure Browser notifications

Authorizations:

BasicAuth

Request Body schema: application/json

| value |

object (BrowserNotificationConfiguration)

|

Responses

200

Browser notification configuration updated

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/config/notifications/browser

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/browser

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{ "value": {

"goLiveMessage": "string",

"enabled": true

}

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SetBrowserNotificationConfigurationOptions

Responses

204

No Content

options/admin/config/notifications/browser

Localhost port 8080

http://localhost:8080/api/admin/config/notifications/browser

Get all the webhooks

Authorizations:

BasicAuth

Responses

200

All webhooks

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/webhooks

Localhost port 8080

http://localhost:8080/api/admin/webhooks

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"timestamp": "2019-08-24T14:15:22Z",

"lastUsed": "2019-08-24T14:15:22Z",

"url": "string",

"events": ["CHAT" ],

"id": 0

}

]`

GetWebhooksOptions

Responses

204

No Content

options/admin/webhooks

Localhost port 8080

http://localhost:8080/api/admin/webhooks

Delete a single webhook

Authorizations:

BasicAuth

Request Body schema: application/json

| id |

integer

|

Responses

200

Webhook successfully deleted

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/webhooks/delete

Localhost port 8080

http://localhost:8080/api/admin/webhooks/delete

Request samples

  • Payload

Content type application/json

Copy

`{ "id": 0

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

DeleteWebhookOptions

Responses

204

No Content

options/admin/webhooks/delete

Localhost port 8080

http://localhost:8080/api/admin/webhooks/delete

Create a single webhook

Authorizations:

BasicAuth

Request Body schema: application/json

| url |

string

| | events |

Array of strings (WebhookEventType)

Items Enum: "CHAT" "USER_JOINED" "USER_PARTED" "NAME_CHANGE" "VISIBILITY-UPDATE" "PING" "PONG" "STREAM_STARTED" "STREAM_STOPPED" "STREAM_TITLE_UPDATED" "SYSTEM" "CHAT_ACTION"

|

Responses

200

The new webhook

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/webhooks/create

Localhost port 8080

http://localhost:8080/api/admin/webhooks/create

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"url": "string",

"events": ["CHAT" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"timestamp": "2019-08-24T14:15:22Z",

"lastUsed": "2019-08-24T14:15:22Z",

"url": "string",

"events": ["CHAT" ],

"id": 0

}`

CreateWebhookOptions

Responses

204

No Content

options/admin/webhooks/create

Localhost port 8080

http://localhost:8080/api/admin/webhooks/create

Get all access tokens

Authorizations:

BasicAuth

Responses

200

List of external API users

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/accesstokens

Localhost port 8080

http://localhost:8080/api/admin/accesstokens

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`[ {

"createdAt": "2019-08-24T14:15:22Z",

"lastUsedAt": "2019-08-24T14:15:22Z",

"id": "string",

"accessToken": "string",

"displayName": "string",

"type": "string",

"scopes": ["string" ],

"displayColor": 0,

"isBot": true

}

]`

GetExternalAPIUsersOptions

Responses

204

No Content

options/admin/accesstokens

Localhost port 8080

http://localhost:8080/api/admin/accesstokens

Delete a single external API user

Authorizations:

BasicAuth

Request Body schema: application/json

| token |

string

|

Responses

200

External API user successfully deleted

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/accesstokens/delete

Localhost port 8080

http://localhost:8080/api/admin/accesstokens/delete

Request samples

  • Payload

Content type application/json

Copy

`{ "token": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

DeleteExternalAPIUserOptions

Responses

204

No Content

options/admin/accesstokens/delete

Localhost port 8080

http://localhost:8080/api/admin/accesstokens/delete

Create a single access token

Authorizations:

BasicAuth

Request Body schema: application/json

| name |

string

| | scopes |

Array of strings

|

Responses

200

The new external API user

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/accesstokens/create

Localhost port 8080

http://localhost:8080/api/admin/accesstokens/create

Request samples

  • Payload

Content type application/json

Copy Expand all Collapse all

`{

"name": "string",

"scopes": ["string" ]

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"createdAt": "2019-08-24T14:15:22Z",

"lastUsedAt": "2019-08-24T14:15:22Z",

"id": "string",

"accessToken": "string",

"displayName": "string",

"type": "string",

"scopes": ["string" ],

"displayColor": 0,

"isBot": true

}`

CreateExternalAPIUserOptions

Responses

204

No Content

options/admin/accesstokens/create

Localhost port 8080

http://localhost:8080/api/admin/accesstokens/create

Return the auto-update features that are supported for this instance

Authorizations:

BasicAuth

Responses

200

Current auto-update options

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/update/options

Localhost port 8080

http://localhost:8080/api/admin/update/options

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"supportsUpdate": true,

"canRestart": true

}`

AutoUpdateOptionsOptions

Responses

204

No Content

options/admin/update/options

Localhost port 8080

http://localhost:8080/api/admin/update/options

Begin the auto-update

Authorizations:

BasicAuth

Responses

200

Console output from update

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/update/start

Localhost port 8080

http://localhost:8080/api/admin/update/start

Response samples

  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

AutoUpdateStartOptions

Responses

204

No Content

options/admin/update/start

Localhost port 8080

http://localhost:8080/api/admin/update/start

Force quit the server and restart it

Authorizations:

BasicAuth

Responses

200

Server force restart has been ordered

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/update/forcequit

Localhost port 8080

http://localhost:8080/api/admin/update/forcequit

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

AutoUpdateForceQuitOptions

Responses

204

No Content

options/admin/update/forcequit

Localhost port 8080

http://localhost:8080/api/admin/update/forcequit

Reset YP configuration

Authorizations:

BasicAuth

Responses

200

YP Registration has been reset

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/yp/reset

Localhost port 8080

http://localhost:8080/api/admin/yp/reset

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

ResetYPRegistrationOptions

Responses

204

No Content

options/admin/yp/reset

Localhost port 8080

http://localhost:8080/api/admin/yp/reset

Get video playback metrics

Authorizations:

BasicAuth

Responses

200

Video playback metrics

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/metrics/video

Localhost port 8080

http://localhost:8080/api/admin/metrics/video

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"errors": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"qualityVariantChanges": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"highestLatency": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"medianLatency": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"lowestLatency": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"medianSegmentDownloadDuration": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"maximumSegmentDownloadDuration": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"minimumSegmentDownloadDuration": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"minPlayerBitrate": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"medianPlayerBitrate": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"maxPlayerBitrate": [ {

"time": "2019-08-24T14:15:22Z",

"value": 0.1

}

],

"availableBitrates": [0 ],

"segmentLength": 0,

"representation": 0

}`

GetVideoPlaybackMetricsOptions

Responses

204

No Content

options/admin/metrics/video

Localhost port 8080

http://localhost:8080/api/admin/metrics/video

Endpoint to interface with Prometheus

This endpoint interfaces with the Prometheus metrics API.

Learn more about it on the Prometheus API docs

get/admin/prometheus

Localhost port 8080

http://localhost:8080/api/admin/prometheus

Endpoint to interface with Prometheus

This endpoint interfaces with the Prometheus metrics API.

Learn more about it on the Prometheus API docs

post/admin/prometheus

Localhost port 8080

http://localhost:8080/api/admin/prometheus

Endpoint to interface with Prometheus

This endpoint interfaces with the Prometheus metrics API.

Learn more about it on the Prometheus API docs

put/admin/prometheus

Localhost port 8080

http://localhost:8080/api/admin/prometheus

Endpoint to interface with Prometheus

This endpoint interfaces with the Prometheus metrics API.

Learn more about it on the Prometheus API docs

delete/admin/prometheus

Localhost port 8080

http://localhost:8080/api/admin/prometheus

Endpoint to interface with Prometheus

This endpoint interfaces with the Prometheus metrics API.

Learn more about it on the Prometheus API docs

options/admin/prometheus

Localhost port 8080

http://localhost:8080/api/admin/prometheus

Send a public message to the Fediverse from the server's user

Authorizations:

BasicAuth

Request Body schema: application/json

A single value that is used in the request

| value |

string or boolean or Array of strings or number

|

Responses

200

Message sent

400

Bad request

401

Basic auth failure

default

Unexpected error

post/admin/federation/send

Localhost port 8080

http://localhost:8080/api/admin/federation/send

Request samples

  • Payload

Content type application/json

Copy

`{ "value": "string"

}`

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy

`{

"message": "string",

"success": true

}`

SendFederatedMessageOptions

Responses

204

No Content

options/admin/federation/send

Localhost port 8080

http://localhost:8080/api/admin/federation/send

Get a paginated list of federated activities

Authorizations:

BasicAuth

query Parameters

| offset |

integer

The number of items to skip before starting to collect the result set

| | limit |

integer

The numbers of items to return

|

Responses

200

A paginated list of federated activities

400

Bad request

401

Basic auth failure

default

Unexpected error

get/admin/federation/actions

Localhost port 8080

http://localhost:8080/api/admin/federation/actions

Response samples

  • 200
  • 400
  • default

Content type application/json

Copy Expand all Collapse all

`{

"total": 0,

"results": {

"timestamp": "2019-08-24T14:15:22Z",

"iri": "string",

"actorIRI": "string",

"type": "string"

}

}`

GetFederatedActionsOptions

Responses

204

No Content

options/admin/federation/actions

Localhost port 8080

http://localhost:8080/api/admin/federation/actions

SendSystemMessageOptions

Responses

204

No Content

options/integrations/chat/system

Localhost port 8080

http://localhost:8080/api/integrations/chat/system

SendSystemMessageToConnectedClientOptions

path Parameters

| clientId required |

integer

The ID of the specified client

|

Responses

204

No Content

options/integrations/chat/system/client/{clientId}

Localhost port 8080

http://localhost:8080/api/integrations/chat/system/client/{clientId}

SendUserMessageOptions Deprecated

Responses

204

No Content

options/integrations/chat/user

Localhost port 8080

http://localhost:8080/api/integrations/chat/user

SendIntegrationChatMessageOptions

Responses

204

No Content

options/integrations/chat/send

Localhost port 8080

http://localhost:8080/api/integrations/chat/send

SendChatActionOptions

Responses

204

No Content

options/integrations/chat/action

Localhost port 8080

http://localhost:8080/api/integrations/chat/action

ExternalUpdateMessageVisibilityOptions

Responses

204

No Content

options/integrations/chat/messagevisibility

Localhost port 8080

http://localhost:8080/api/integrations/chat/messagevisibility

ExternalSetStreamTitleOptions

Responses

204

No Content

options/integrations/streamtitle

Localhost port 8080

http://localhost:8080/api/integrations/streamtitle

ExternalGetChatMessagesOptions

Responses

204

No Content

options/integrations/chat

Localhost port 8080

http://localhost:8080/api/integrations/chat

ExternalGetConnectedChatClientsOptions

Responses

204

No Content

options/integrations/clients

Localhost port 8080

http://localhost:8080/api/integrations/clients