openapi: 3.0.3

info:

title: PeerTube

version: 8.1.0

contact:

name: PeerTube Community

url: https://joinpeertube.org

license:

name: AGPLv3.0

url: https://github.com/Chocobozzz/PeerTube/blob/master/LICENSE

x-logo:

url: https://joinpeertube.org/img/brand.png

altText: PeerTube Project Homepage

description: |

The PeerTube API is built on HTTP(S) and is RESTful. You can use your favorite

HTTP/REST library for your programming language to use PeerTube.

See the [REST API quick start](https://docs.joinpeertube.org/api/rest-getting-started) for a few

examples of using the PeerTube API.

# Authentication

When you sign up for an account on a PeerTube instance, you are given the possibility

to generate sessions on it, and authenticate there using an access token. Only __one

access token can currently be used at a time__.

## Roles

Accounts are given permissions based on their role. There are three roles on

PeerTube: Administrator, Moderator, and User. See the [roles guide](https://docs.joinpeertube.org/admin/managing-users#roles) for a detail of their permissions.

# Errors

The API uses standard HTTP status codes to indicate the success or failure

of the API call, completed by a [RFC7807-compliant](https://tools.ietf.org/html/rfc7807) response body.

```

HTTP 1.1 404 Not Found

Content-Type: application/problem+json; charset=utf-8

{

"detail": "Video not found",

"docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",

"status": 404,

"title": "Not Found",

"type": "about:blank"

}

```

We provide error `type` (following RFC7807) and `code` (internal PeerTube code) values for [a growing number of cases](https://github.com/Chocobozzz/PeerTube/blob/develop/packages/models/src/server/server-error-code.enum.ts),

but it is still optional. Types are used to disambiguate errors that bear the same status code

and are non-obvious:

```

HTTP 1.1 403 Forbidden

Content-Type: application/problem+json; charset=utf-8

{

"detail": "Cannot get this video regarding follow constraints",

"docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",

"status": 403,

"title": "Forbidden",

"type": "https://docs.joinpeertube.org/api-rest-reference.html#section/Errors/does_not_respect_follow_constraints"

}

```

Here a 403 error could otherwise mean that the video is private or blocklisted.

### Validation errors

Each parameter is evaluated on its own against a set of rules before the route validator

proceeds with potential testing involving parameter combinations. Errors coming from validation

errors appear earlier and benefit from a more detailed error description:

```

HTTP 1.1 400 Bad Request

Content-Type: application/problem+json; charset=utf-8

{

"detail": "Incorrect request parameters: id",

"docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",

"instance": "/api/v1/videos/9c9de5e8-0a1e-484a-b099-e80766180",

"invalid-params": {

"id": {

"location": "params",

"msg": "Invalid value",

"param": "id",

"value": "9c9de5e8-0a1e-484a-b099-e80766180"

}

},

"status": 400,

"title": "Bad Request",

"type": "about:blank"

}

```

Where `id` is the name of the field concerned by the error, within the route definition.

`invalid-params.<field>.location` can be either 'params', 'body', 'header', 'query' or 'cookies', and

`invalid-params.<field>.value` reports the value that didn't pass validation whose `invalid-params.<field>.msg`

is about.

### Deprecated error fields

Some fields could be included with previous versions. They are still included but their use is deprecated:

- `error`: superseded by `detail`

# Rate limits

We are rate-limiting all endpoints of PeerTube's API. Custom values can be set by administrators:

| Endpoint (prefix: `/api/v1`) | Calls | Time frame |

|------------------------------|---------------|--------------|

| `/*` | 50 | 10 seconds |

| `POST /users/token` | 15 | 5 minutes |

| `POST /users/register` | 2^* | 5 minutes |

| `POST /users/ask-send-verify-email` | 3 | 5 minutes |

Depending on the endpoint, ^*failed requests are not taken into account. A service

limit is announced by a `429 Too Many Requests` status code.

You can get details about the current state of your rate limit by reading the

following headers:

| Header | Description |

|-------------------------|------------------------------------------------------------|

| `X-RateLimit-Limit` | Number of max requests allowed in the current time period |

| `X-RateLimit-Remaining` | Number of remaining requests in the current time period |

| `X-RateLimit-Reset` | Timestamp of end of current time period as UNIX timestamp |

| `Retry-After` | Seconds to delay after the first `429` is received |

# CORS

This API features [Cross-Origin Resource Sharing (CORS)](https://fetch.spec.whatwg.org/),

allowing cross-domain communication from the browser for some routes:

| Endpoint |

|------------------------- ---|

| `/api/*` |

| `/download/*` |

| `/lazy-static/*` |

| `/.well-known/webfinger` |

In addition, all routes serving ActivityPub are CORS-enabled for all origins.

externalDocs:

url: https://docs.joinpeertube.org/api-rest-reference.html

tags:

- name: Register

description: |

As a visitor, you can use this API to open an account (if registrations are open on

that PeerTube instance). As an admin, you should use the dedicated [User creation

API](#operation/addUser) instead.

- name: Session

x-displayName: Login/Logout

description: |

Sessions deal with access tokens over time. Only __one session token can currently be used at a time__.

- name: Accounts

description: >

Accounts encompass remote accounts discovered across the federation,

and correspond to the main Actor, along with video channels a user can create, which

are also Actors.

When a comment is posted, it is done with your Account's Actor.

- name: Users

description: >

Using some features of PeerTube require authentication, for which User

provide different levels of permission as well as associated user

information. Each user has a corresponding local Account for federation.

- name: User Exports

description: >

To create an archive of user data.

- name: User Imports

description: >

To import an archive of user data.

- name: My User

description: >

Operations related to your own User, when logged-in.

- name: My Subscriptions

description: >

Operations related to your subscriptions to video channels, their

new videos, and how to keep up to date with their latest publications!

- name: My History

description: >

Operations related to your watch history.

- name: My Notifications

description: >

Notifications following new videos, follows or reports. They allow you

to keep track of the interactions and overall important information that

concerns you. You MAY set per-notification type delivery preference, to

receive the info either by mail, by in-browser notification or both.

- name: Config

description: >

Each server exposes public information regarding supported videos and

options.

- name: Job

description: >

Jobs are long-running tasks enqueued and processed by the instance

itself. No additional worker registration is currently available.

- name: Instance Follows

description: >

Managing servers which the instance interacts with is crucial to the

concept of federation in PeerTube and external video indexation. The PeerTube

server then deals with inter-server ActivityPub operations and propagates

information across its social graph by posting activities to actors' inbox

endpoints.

externalDocs:

url: https://docs.joinpeertube.org/admin/following-instances#instances-follows

- name: Instance Redundancy

description: >

Redundancy is part of the inter-server solidarity that PeerTube fosters.

Manage the list of instances you wish to help by seeding their videos according

to the policy of video selection of your choice. Note that you have a similar functionality

to mirror individual videos, see [video mirroring](#tag/Video-Mirroring).

externalDocs:

url: https://docs.joinpeertube.org/admin/following-instances#instances-redundancy

- name: Plugins

description: >

Managing plugins installed from a local path or from NPM, or search for new ones.

externalDocs:

url: https://docs.joinpeertube.org/api/plugins

- name: Abuses

description: |

Abuses deal with reports of local or remote videos/comments/accounts alike.

- name: Video

description: |

Operations dealing with listing, uploading, fetching or modifying videos.

- name: Video Upload

description: |

Operations dealing with adding video or audio. PeerTube supports two upload modes, and three import modes.

### Upload

- [_legacy_](#operation/uploadLegacy), where the video file is sent in a single request

- [_resumable_](#operation/uploadResumableInit), where the video file is sent in chunks

You can upload videos more reliably by using the resumable variant. Its protocol lets

you resume an upload operation after a network interruption or other transmission failure,

saving time and bandwidth in the event of network failures.

Favor using resumable uploads in any of the following cases:

- You are transferring large files

- The likelihood of a network interruption is high

- Uploads are originating from a device with a low-bandwidth or unstable Internet connection,

such as a mobile device

### Import

- _URL_-based: where the URL points to any service supported by [youtube-dl](https://ytdl-org.github.io/youtube-dl/)

- _magnet_-based: where the URI resolves to a BitTorrent resource containing a single supported video file

- _torrent_-based: where the metainfo file resolves to a BitTorrent resource containing a single supported video file

The import function is practical when the desired video/audio is available online. It makes PeerTube

download it for you, saving you as much bandwidth and avoiding any instability or limitation your network might have.

- name: Video Imports

description: Operations dealing with listing, adding and removing video imports.

- name: Channels Sync

description: Operations dealing with synchronizing PeerTube user's channel with channels of other platforms

- name: Video Captions

description: Operations dealing with listing, adding and removing closed captions of a video.

- name: Video Chapters

description: Operations dealing with managing chapters of a video.

- name: Video Channels

description: Operations dealing with the creation, modification and listing of videos within a channel.

- name: Player Settings

description: Operations dealing with video player settings for videos and channels.

- name: Video Comments

description: >

Operations dealing with comments to a video. Comments are organized in threads: adding a

comment in response to the video starts a thread, adding a reply to a comment adds it to

its root comment thread.

- name: Video Blocks

description: Operations dealing with blocking videos (removing them from view and preventing interactions).

- name: Automatic Tags

description: Automatic tags set on objects (like comments or videos) by specific rules (external link, watched words, etc.)

- name: Watched Words

description: Manage list of watched words to detect patterns on objects (like comments of videos)

- name: Video Rates

description: Like/dislike a video.

- name: Video Playlists

description: Operations dealing with playlists of videos. Playlists are bound to users and/or channels.

- name: Video Files

description: Operations on video files

- name: Video Transcoding

description: Video transcoding related operations

- name: Video Stats

description: Video statistics

- name: Video Feeds

description: Server syndication feeds of videos

- name: Video Download

description: Download video files

- name: Search

description: |

The search helps to find _videos_ or _channels_ from within the instance and beyond.

Videos from other instances federated by the instance (that is, instances

followed by the instance) can be found via keywords and other criteria of

the advanced search.

Administrators can also enable the use of a remote search system, indexing

videos and channels not could be not federated by the instance.

- name: Homepage

description: Get and update the custom homepage

- name: Video Mirroring

description: |

PeerTube instances can mirror videos from one another, and help distribute some videos.

For importing videos as your own, refer to [video imports](#operation/importVideo).

- name: Stats

description: |

Statistics

- name: Runner Registration Token

description: |

Manage runner registration token

- name: Video Passwords

description: Operation on video passwords

- name: Client Config

description: Configuration of the web client

x-tagGroups:

- name: Static endpoints

tags:

- Static Video Files

- name: Download

tags:

- Video Download

- name: Feeds

tags:

- Video Feeds

- name: Auth

tags:

- Register

- Session

- name: Accounts

tags:

- Accounts

- Users

- User Exports

- User Imports

- My User

- My Subscriptions

- My Notifications

- My History

- name: Videos

tags:

- Video

- Video Upload

- Video Imports

- Video Captions

- Video Chapters

- Video Channels

- Video Comments

- Video Rates

- Video Playlists

- Video Stats

- Ownership Change

- Video Mirroring

- Video Files

- Video Transcoding

- Live Videos

- Channels Sync

- Video Passwords

- Video Embed Privacy

- name: Search

tags:

- Search

- name: Moderation

tags:

- Abuses

- Video Blocks

- Account Blocklist

- Server Blocklist

- Automatic Tags

- Watched Words

- name: Instance

tags:

- Config

- Client Config

- Homepage

- Instance Follows

- Instance Redundancy

- Plugins

- Stats

- Logs

- Job

- name: Remote Jobs

tags:

- Runner Registration Token

- Runner Jobs

- Runners

paths:

'/static/web-videos/{filename}':

get:

tags:

- Static Video Files

summary: Get public Web Video file

description: "**PeerTube >= 6.0**"

parameters:

- $ref: '#/components/parameters/staticFilename'

responses:

'200':

description: successful operation

'404':

description: not found

'/static/web-videos/private/{filename}':

get:

tags:

- Static Video Files

summary: Get private Web Video file

description: "**PeerTube >= 6.0**"

parameters:

- $ref: '#/components/parameters/staticFilename'

- $ref: '#/components/parameters/videoFileToken'

security:

- OAuth2: []

responses:

'200':

description: successful operation

'403':

description: invalid auth

'404':

description: not found

'/static/streaming-playlists/hls/{filename}':

get:

tags:

- Static Video Files

summary: Get public HLS video file

parameters:

- $ref: '#/components/parameters/staticFilename'

security:

- OAuth2: []

responses:

'200':

description: successful operation

'403':

description: invalid auth

'404':

description: not found

'/static/streaming-playlists/hls/private/{filename}':

get:

tags:

- Static Video Files

summary: Get private HLS video file

parameters:

- $ref: '#/components/parameters/staticFilename'

- $ref: '#/components/parameters/videoFileToken'

- $ref: '#/components/parameters/reinjectVideoFileToken'

security:

- OAuth2: []

responses:

'200':

description: successful operation

'403':

description: invalid auth

'404':

description: not found

'/download/videos/generate/{videoId}':

get:

tags:

- Video Download

summary: Download video file

description: Generate a mp4 container that contains at most 1 video stream and at most 1 audio stream.

Mainly used to merge the HLS audio only video file and the HLS video only resolution file.

parameters:

- name: videoId

in: path

required: true

description: The video id

schema:

$ref: '#/components/schemas/Video/properties/id'

- name: videoFileIds

in: query

required: true

description: streams of video files to mux in the output

schema:

type: array

items:

type: integer

- $ref: '#/components/parameters/videoFileToken'

responses:

'200':

description: successful operation

'/feeds/video-comments.{format}':

get:

tags:

- Video Feeds

summary: Comments on videos feeds

operationId: getSyndicatedComments

parameters:

- name: format

in: path

required: true

description: 'format expected (we focus on making `rss` the most feature-rich ; it serves [Media RSS](https://www.rssboard.org/media-rss))'

schema:

type: string

enum:

- xml

- rss

- rss2

- atom

- atom1

- json

- json1

- name: videoId

in: query

description: 'limit listing comments to a specific video'

schema:

type: string

- name: accountId

in: query

description: 'limit listing comments to videos of a specific account'

schema:

type: string

- name: accountName

in: query

description: 'limit listing comments to videos of a specific account'

schema:

type: string

- name: videoChannelId

in: query

description: 'limit listing comments to videos of a specific video channel'

schema:

type: string

- name: videoChannelName

in: query

description: 'limit listing comments to videos of a specific video channel'

schema:

type: string

responses:

'200':

description: successful operation

headers:

Cache-Control:

schema:

type: string

default: 'max-age=900' # 15 min cache

content:

application/xml:

schema:

$ref: '#/components/schemas/VideoCommentsForXML'

examples:

nightly:

externalValue: https://peertube2.cpy.re/feeds/video-comments.xml?scope=local

application/rss+xml:

schema:

$ref: '#/components/schemas/VideoCommentsForXML'

examples:

nightly:

externalValue: https://peertube2.cpy.re/feeds/video-comments.rss?scope=local

text/xml:

schema:

$ref: '#/components/schemas/VideoCommentsForXML'

examples:

nightly:

externalValue: https://peertube2.cpy.re/feeds/video-comments.xml?scope=local

application/atom+xml:

schema:

$ref: '#/components/schemas/VideoCommentsForXML'

examples:

nightly:

externalValue: https://peertube2.cpy.re/feeds/video-comments.atom?scope=local

application/json:

schema:

type: object

examples:

nightly:

externalValue: https://peertube2.cpy.re/feeds/video-comments.json?scope=local

'400':

x-summary: field inconsistencies

description: >

Arises when:

- videoId filter is mixed with a channel filter

'404':

description: video, video channel or account not found

'406':

description: accept header unsupported

'/feeds/videos.{format}':

get:

tags:

- Video Feeds

summary: Common videos feeds

operationId: getSyndicatedVideos

parameters:

- name: format

in: path

required: true

description: 'format expected (we focus on making `rss` the most feature-rich ; it serves [Media RSS](https://www.rssboard.org/media-rss))'

schema:

type: string

enum:

- xml

- rss

- rss2

- atom

- atom1

- json

- json1

- name: accountId

in: query

description: 'limit listing to a specific account'

schema:

type: string

- name: accountName

in: query

description: 'limit listing to a specific account'

schema:

type: string

- name: videoChannelId

in: query

description: 'limit listing to a specific video channel'

schema:

type: string

- name: videoChannelName

in: query

description: 'limit listing to a specific video channel'

schema:

type: string

- $ref: '#/components/parameters/sort'

- $ref: '#/components/parameters/nsfw'

- $ref: '#/components/parameters/isLocal'

- $ref: '#/components/parameters/include'

- $ref: '#/components/parameters/privacyOneOf'

- $ref: '#/components/parameters/hasHLSFiles'

- $ref: '#/components/parameters/hasWebVideoFiles'

responses:

'200':

description: successful operation

headers:

Cache-Control:

schema:

type: string

default: 'max-age=900' # 15 min cache

content:

application/xml:

schema:

$ref: '#/components/schemas/VideosForXML'

examples:

nightly:

externalValue: https://peertube2.cpy.re/feeds/videos.xml?scope=local

application/rss+xml:

schema:

$ref: '#/components/schemas/VideosForXML'

examples:

nightly:

externalValue: https://peertube2.cpy.re/feeds/videos.rss?scope=local

text/xml:

schema:

$ref: '#/components/schemas/VideosForXML'

examples:

nightly:

externalValue: https://peertube2.cpy.re/feeds/videos.xml?scope=local

application/atom+xml:

schema:

$ref: '#/components/schemas/VideosForXML'

examples:

nightly:

externalValue: https://peertube2.cpy.re/feeds/videos.atom?scope=local

application/json:

schema:

type: object

examples:

nightly:

externalValue: https://peertube2.cpy.re/feeds/videos.json?scope=local

'404':

description: video channel or account not found

'406':

description: accept header unsupported

'/feeds/subscriptions.{format}':

get:

tags:

- Video Feeds

summary: Videos of subscriptions feeds

operationId: getSyndicatedSubscriptionVideos

parameters:

- name: format

in: path

required: true

description: 'format expected (we focus on making `rss` the most feature-rich ; it serves [Media RSS](https://www.rssboard.org/media-rss))'

schema:

type: string

enum:

- xml

- rss

- rss2

- atom

- atom1

- json

- json1

- name: accountId

in: query

description: limit listing to a specific account

schema:

type: string

required: true

- name: token

in: query

description: private token allowing access

schema:

type: string

required: true

- $ref: '#/components/parameters/sort'

- $ref: '#/components/parameters/nsfw'

- $ref: '#/components/parameters/isLocal'

- $ref: '#/components/parameters/include'

- $ref: '#/components/parameters/privacyOneOf'

- $ref: '#/components/parameters/hasHLSFiles'

- $ref: '#/components/parameters/hasWebVideoFiles'

responses:

'200':

description: successful operation

headers:

Cache-Control:

schema:

type: string

default: 'max-age=900' # 15 min cache

content:

application/xml:

schema:

$ref: '#/components/schemas/VideosForXML'

application/rss+xml:

schema:

$ref: '#/components/schemas/VideosForXML'

text/xml:

schema:

$ref: '#/components/schemas/VideosForXML'

application/atom+xml:

schema:

$ref: '#/components/schemas/VideosForXML'

application/json:

schema:

type: object

'406':

description: accept header unsupported

'/feeds/podcast/videos.xml':

get:

tags:

- Video Feeds

summary: Videos podcast feed

operationId: getVideosPodcastFeed

parameters:

- name: videoChannelId

in: query

description: 'Limit listing to a specific video channel'

required: true

schema:

type: string

responses:

'200':

description: successful operation

headers:

Cache-Control:

schema:

type: string

default: 'max-age=900' # 15 min cache

'404':

description: video channel not found

'/api/v1/accounts/{name}':

get:

tags:

- Accounts

summary: Get an account

operationId: getAccount

parameters:

- $ref: '#/components/parameters/name'

responses:

'200':

description: successful operation

content:

application/json:

schema:

$ref: '#/components/schemas/Account'

'404':

description: account not found

'/api/v1/accounts/{name}/videos':

get:

tags:

- Accounts

- Video

summary: 'List videos of an account'

operationId: getAccountVideos

parameters:

- $ref: '#/components/parameters/name'

# Common video filter parameters

- $ref: '#/components/parameters/start'

- $ref: '#/components/parameters/count'

- $ref: '#/components/parameters/skipCount'

- $ref: '#/components/parameters/videosSort'

- $ref: '#/components/parameters/nsfw'

- $ref: '#/components/parameters/nsfwFlagsIncluded'

- $ref: '#/components/parameters/nsfwFlagsExcluded'

- $ref: '#/components/parameters/isLive'

- $ref: '#/components/parameters/includeScheduledLive'

- $ref: '#/components/parameters/categoryOneOf'

- $ref: '#/components/parameters/licenceOneOf'

- $ref: '#/components/parameters/languageOneOf'

- $ref: '#/components/parameters/tagsOneOf'

- $ref: '#/components/parameters/tagsAllOf'

- $ref: '#/components/parameters/isLocal'

- $ref: '#/components/parameters/include'

- $ref: '#/components/parameters/hasHLSFiles'

- $ref: '#/components/parameters/hasWebVideoFiles'

- $ref: '#/components/parameters/host'

- $ref: '#/components/parameters/autoTagOneOfVideo'

- $ref: '#/components/parameters/stateOneOfVideo'

- $ref: '#/components/parameters/privacyOneOf'

- $ref: '#/components/parameters/excludeAlreadyWatched'

- $ref: '#/components/parameters/search'

responses:

'200':

description: successful operation

content:

application/json:

schema:

$ref: '#/components/schemas/VideoListResponse'

x-codeSamples:

- lang: JavaScript

source: |

fetch('https://peertube2.cpy.re/api/v1/accounts/{name}/videos')

.then(function(response) {

return response.json()

}).then(function(data) {

console.log(data)

})

- lang: Shell

source: |

## DEPENDENCIES: jq

curl -s https://peertube2.cpy.re/api/v1/accounts/{name}/videos | jq

- lang: Ruby

source: |

require 'net/http'

require 'json'

uri = URI.parse("https://peertube2.cpy.re/api/v1/accounts/{name}/videos")

http = Net::HTTP.new(uri.host, uri.port)

http.use_ssl = true

response = http.get(uri.request_uri)

puts JSON.parse(response.read_body)

- lang: Python

source: |

import requests

r = requests.get("https://peertube2.cpy.re/api/v1//accounts/{name}/videos")

json = r.json()

print(json)

'/api/v1/accounts/{name}/followers':

get:

tags:

- Accounts

summary: 'List followers of an account'

security:

- OAuth2: []

operationId: getAccountFollowers

parameters:

- $ref: '#/components/parameters/name'

- $ref: '#/components/parameters/start'

- $ref: '#/components/parameters/count'

- $ref: '#/components/parameters/followersSort'

- $ref: '#/components/parameters/search'

responses:

'200':

description: successful operation

content:

application/json:

schema:

type: object

properties:

total:

type: integer

example: 1

data:

type: array

items:

$ref: '#/components/schemas/Follow'

/api/v1/accounts:

get:

tags:

- Accounts

summary: List accounts

operationId: getAccounts

parameters:

- $ref: '#/components/parameters/start'

- $ref: '#/components/parameters/count'

- $ref: '#/components/parameters/sort'

responses:

'200':

description: successful operation

content:

'application/json':

schema:

type: object

properties:

total:

type: integer

example: 1

data:

type: array

items:

$ref: '#/components/schemas/Account'

/api/v1/config:

get:

tags:

- Config

summary: Get instance public configuration

operationId: getConfig

responses:

'200':

description: successful operation

content:

application/json:

schema:

$ref: '#/components/schemas/ServerConfig'

examples:

nightly:

externalValue: https://peertube2.cpy.re/api/v1/config

/api/v1/config/about:

get:

summary: Get instance "About" information

operationId: getAbout

tags:

- Config

responses:

'200':

description: successful operation

content:

application/json:

schema:

$ref: '#/components/schemas/ServerConfigAbout'

examples:

nightly:

externalValue: https://peertube2.cpy.re/api/v1/config/about

/api/v1/config/custom:

get:

summary: Get instance runtime configuration

operationId: getCustomConfig

tags:

- Config

security:

- OAuth2:

- admin

responses:

'200':

description: successful operation

content:

application/json:

schema:

$ref: '#/components/schemas/ServerConfigCustom'

put:

summary: Set instance runtime configuration

operationId: putCustomConfig

tags:

- Config

security:

- OAuth2:

- admin

responses:

'200':

description: successful operation

'400':

x-summary: field inconsistencies

description: >

Arises when:

- the emailer is disabled and the instance is open to registrations

- web videos and hls are disabled with transcoding enabled - you need at least one enabled

delete:

summary: Delete instance runtime configuration

operationId: delCustomConfig

tags:

- Config

security:

- OAuth2:

- admin

responses:

'200':

description: successful operation

/api/v1/config/instance-banner/pick:

post:

summary: Update instance banner

security:

- OAuth2:

- admin

tags:

- Config

responses:

'204':