Sonarr Naming Settings API
The NamingSettings API from Sonarr — 3 operation(s) for namingsettings.
The NamingSettings API from Sonarr — 3 operation(s) for namingsettings.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/sonarr:sonarr-namingsettings-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Sonarr Naming Settings API
description: Sonarr API docs - The v5 API docs apply to Sonarr v5 only.
license:
name: GPL-3.0
url: https://github.com/Sonarr/Sonarr/blob/develop/LICENSE
version: 5.0.0
servers:
- url: '{protocol}://{hostpath}'
variables:
protocol:
default: http
enum:
- http
- https
hostpath:
default: localhost:8989
security:
- X-Api-Key: []
- apikey: []
tags:
- name: NamingSettings
paths:
/api/v5/settings/naming:
get:
tags:
- NamingSettings
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/NamingSettingsResource'
summary: Get api settings naming
x-summary-source: derived
operationId: getApiV5SettingsNaming
x-operation-id-source: derived
/api/v5/settings/naming/{id}:
put:
tags:
- NamingSettings
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/NamingSettingsResource'
responses:
'202':
description: Accepted
content:
application/json:
schema:
$ref: '#/components/schemas/NamingSettingsResource'
'404':
description: Not Found
summary: Replace api settings naming by id
x-summary-source: derived
operationId: putApiV5SettingsNamingById
x-operation-id-source: derived
get:
tags:
- NamingSettings
parameters:
- name: id
in: path
required: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/NamingSettingsResource'
'404':
description: Not Found
summary: Get api settings naming by id
x-summary-source: derived
operationId: getApiV5SettingsNamingById
x-operation-id-source: derived
/api/v5/settings/naming/examples:
get:
tags:
- NamingSettings
parameters:
- name: renameEpisodes
in: query
schema:
type: boolean
- name: replaceIllegalCharacters
in: query
schema:
type: boolean
- name: colonReplacementFormat
in: query
schema:
type: integer
format: int32
- name: customColonReplacementFormat
in: query
schema:
type: string
- name: multiEpisodeStyle
in: query
schema:
type: integer
format: int32
- name: standardEpisodeFormat
in: query
schema:
type: string
- name: dailyEpisodeFormat
in: query
schema:
type: string
- name: animeEpisodeFormat
in: query
schema:
type: string
- name: seriesFolderFormat
in: query
schema:
type: string
- name: seasonFolderFormat
in: query
schema:
type: string
- name: specialsFolderFormat
in: query
schema:
type: string
- name: id
in: query
schema:
type: integer
format: int32
- name: resourceName
in: query
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/NamingExampleResource'
summary: Get api settings naming examples
x-summary-source: derived
operationId: getApiV5SettingsNamingExamples
x-operation-id-source: derived
components:
schemas:
NamingSettingsResource:
type: object
properties:
id:
type: integer
format: int32
renameEpisodes:
type: boolean
replaceIllegalCharacters:
type: boolean
colonReplacementFormat:
type: integer
format: int32
customColonReplacementFormat:
type:
- string
- 'null'
multiEpisodeStyle:
type: integer
format: int32
standardEpisodeFormat:
type:
- string
- 'null'
dailyEpisodeFormat:
type:
- string
- 'null'
animeEpisodeFormat:
type:
- string
- 'null'
seriesFolderFormat:
type:
- string
- 'null'
seasonFolderFormat:
type:
- string
- 'null'
specialsFolderFormat:
type:
- string
- 'null'
additionalProperties: false
NamingExampleResource:
type: object
properties:
singleEpisodeExample:
type:
- string
- 'null'
multiEpisodeExample:
type:
- string
- 'null'
dailyEpisodeExample:
type:
- string
- 'null'
animeEpisodeExample:
type:
- string
- 'null'
animeMultiEpisodeExample:
type:
- string
- 'null'
seriesFolderExample:
type:
- string
- 'null'
seasonFolderExample:
type:
- string
- 'null'
specialsFolderExample:
type:
- string
- 'null'
additionalProperties: false
securitySchemes:
X-Api-Key:
type: apiKey
description: Apikey passed as header
name: X-Api-Key
in: header
apikey:
type: apiKey
description: Apikey passed as query parameter
name: apikey
in: query