/
OW
owncast
/
Owncast APIs
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 2h ago · Updated 2w ago
View markdown
owncast
Owncast APIs
get
Get the YP protocol data
latest
OpenAPI 3.1.0
MIT
raw.githubusercontent.com
2026-08-09
245
75
165.4 KB
dc1c42f7f8f6
Chat
1
External
11
Internal
124
get
Get the status of the server
get
Get list of custom emojis supported in the chat
get
Gets a list of chat messages
post
Registers an anonymous chat user
post
Update chat message visibility
post
Enable/disable a user
get
Get the web config
get
Get the YP protocol data
get
Get all social platforms
get
Get a list of video variants available
get
Tell the backend you're an active viewer
post
Request remote follow
get
Gets the list of followers
get
CMCD collector accepting a report as a query parameter
post
CMCD collector accepting event and response mode playback reports
post
Save video playback metrics for future video health recording
post
Register for notifications
get
Get current inboard broadcaster
get
Disconnect inbound stream
get
Get the current server config
get
Get viewer count over time
get
Get active viewers
get
Get the playback clients of active viewers with their current playback health
get
Get the current hardware stats
get
Get a detailed list of currently connected chat clients
get
Get all chat messages for the admin, unfiltered
post
Update visibility of chat messages
post
Enable or disable a user
get
Get a list of disabled users
post
Ban an IP address
post
Remove an IP ban
get
Get all banned IP addresses
post
Set moderator status for a user
get
Get a list of moderator users
get
Get a paginated list of all users
post
Permanently delete a user and all of their data
get
Get all logs
get
Get warning/error logs
get
Get followers
get
Get a list of pending follow requests
get
Get a list of rejected or blocked follows
get
Get directories that are featuring/listing this server
post
Set the following state of a follower or follow request
post
Remove a follower without blocking them (they may follow again)
post
Upload custom emoji
post
Delete custom emoji
post
Change the current admin password
post
Set an array of valid stream keys
post
Change the extra page content in memory
post
Change the stream title
post
Change the welcome message
post
Disable chat
post
Enable chat for user join messages
post
Enable/disable chat established user mode
post
Set chat usernames that are not allowed
post
Set the suggested chat usernames that will be assigned automatically
post
Set spam protection enabled
post
Set slur filter enabled
post
Set require authentication for chat
post
Set video codec
post
Set the number of video segments and duration per segment in a playlist
post
Set an array of video output configurations
post
Set style/color/css values
post
Update logo
post
Upload custom favicon
delete
Reset favicon to default
post
Update server tags
post
Update FFMPEG path
post
Update server port
post
Update server IP address
post
Update RTMP post
post
Update RTMP server bind address
post
Update websocket host override
post
Update custom video serving endpoint
post
Update NSFW marking
post
Update autoplay behavior
post
Update directory enabled
post
Update social handles
post
Update S3 configuration
post
Update server url
post
Update external action links
post
Update custom styles
post
Update custom JavaScript
post
Update hide viewer count
post
Update search indexing
post
Enable/disable federation features
post
Set if federation activities are private
post
Set if fediverse engagement appears in chat
post
Set if posts from this server can be quoted
post
Set if the public followers tab is hidden on the web UI
post
Set local federated username
post
Set federated go live message
post
Set Federation blocked domains
get
Get list of federated servers
get
Get all federated servers (admin), including pending requests
post
Add a federated server to follow
delete
Remove a federated server
get
Get pending requests from other servers to feature this server's stream
post
Configure Discord notifications
post
Configure Browser notifications
get
Get all the webhooks
post
Delete a single webhook
post
Create a single webhook
get
Get all access tokens
post
Delete a single external API user
post
Create a single access token
get
Return the auto-update features that are supported for this instance
get
Begin the auto-update
get
Force quit the server and restart it
get
Reset YP configuration
get
Get video playback metrics
get
Endpoint to interface with Prometheus
put
Endpoint to interface with Prometheus
post
Endpoint to interface with Prometheus
delete
Endpoint to interface with Prometheus
options
Endpoint to interface with Prometheus
post
Send a public message to the Fediverse from the server's user
get
Get a paginated list of federated activities
post
Begins auth flow
get
Handle the redirect from an IndieAuth server to continue the auth flow
get
Handles the IndieAuth auth endpoint
post
Handles IndieAuth from form submission
post
Register a Fediverse OTP request
post
Verify Fediverse OTP code
Objects
109
Internal
Get the YP protocol data
get
/yp
Response
The current YP protocol configuration
YPDetails
required
lastConnectTime
string
name
string
description
string
streamTitle
string
logo
string
tags
string[]
social
SocialHandle[]
viewerCount
integer
overallMaxViewerCount
integer
sessionMaxViewerCount
integer
nsfw
boolean
online
boolean