sonarr-py

Sonarr API docs - The v3 API docs apply to both v3 and v4 versions of Sonarr. Some functionality may only be available in v4 of the Sonarr application.

This Python package is automatically generated by the OpenAPI Generator project:

• API version: v4.0.11.2680
• Package version: 1.0.2
• Generator version: 7.10.0
• Build package: org.openapitools.codegen.languages.PythonClientCodegen

Requirements.

Python 3.8+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/devopsarr/sonarr-py.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/devopsarr/sonarr-py.git)

Then import the package:

import sonarr

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import sonarr

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import sonarr
from sonarr.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:8989
# See configuration.py for a list of all supported configuration parameters.
configuration = sonarr.Configuration(
    host = "http://localhost:8989"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: apikey
configuration.api_key['apikey'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['apikey'] = 'Bearer'

# Configure API key authorization: X-Api-Key
configuration.api_key['X-Api-Key'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['X-Api-Key'] = 'Bearer'


# Enter a context with an instance of the API client
with sonarr.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = sonarr.ApiInfoApi(api_client)

    try:
        api_instance.get_api()
    except ApiException as e:
        print("Exception when calling ApiInfoApi->get_api: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to http://localhost:8989

Class	Method	HTTP request	Description
ApiInfoApi	get_api	GET /api
AuthenticationApi	create_login	POST /login
AuthenticationApi	get_logout	GET /logout
AutoTaggingApi	create_auto_tagging	POST /api/v3/autotagging
AutoTaggingApi	delete_auto_tagging	DELETE /api/v3/autotagging/{id}
AutoTaggingApi	get_auto_tagging_by_id	GET /api/v3/autotagging/{id}
AutoTaggingApi	list_auto_tagging	GET /api/v3/autotagging
AutoTaggingApi	list_auto_tagging_schema	GET /api/v3/autotagging/schema
AutoTaggingApi	update_auto_tagging	PUT /api/v3/autotagging/{id}
BackupApi	create_system_backup_restore_by_id	POST /api/v3/system/backup/restore/{id}
BackupApi	create_system_backup_restore_upload	POST /api/v3/system/backup/restore/upload
BackupApi	delete_system_backup	DELETE /api/v3/system/backup/{id}
BackupApi	list_system_backup	GET /api/v3/system/backup
BlocklistApi	delete_blocklist	DELETE /api/v3/blocklist/{id}
BlocklistApi	delete_blocklist_bulk	DELETE /api/v3/blocklist/bulk
BlocklistApi	get_blocklist	GET /api/v3/blocklist
CalendarApi	get_calendar_by_id	GET /api/v3/calendar/{id}
CalendarApi	list_calendar	GET /api/v3/calendar
CalendarFeedApi	get_feed_v3_calendar_sonarr_ics	GET /feed/v3/calendar/sonarr.ics
CommandApi	create_command	POST /api/v3/command
CommandApi	delete_command	DELETE /api/v3/command/{id}
CommandApi	get_command_by_id	GET /api/v3/command/{id}
CommandApi	list_command	GET /api/v3/command
CustomFilterApi	create_custom_filter	POST /api/v3/customfilter
CustomFilterApi	delete_custom_filter	DELETE /api/v3/customfilter/{id}
CustomFilterApi	get_custom_filter_by_id	GET /api/v3/customfilter/{id}
CustomFilterApi	list_custom_filter	GET /api/v3/customfilter
CustomFilterApi	update_custom_filter	PUT /api/v3/customfilter/{id}
CustomFormatApi	create_custom_format	POST /api/v3/customformat
CustomFormatApi	delete_custom_format	DELETE /api/v3/customformat/{id}
CustomFormatApi	delete_custom_format_bulk	DELETE /api/v3/customformat/bulk
CustomFormatApi	get_custom_format_by_id	GET /api/v3/customformat/{id}
CustomFormatApi	list_custom_format	GET /api/v3/customformat
CustomFormatApi	list_custom_format_schema	GET /api/v3/customformat/schema
CustomFormatApi	put_custom_format_bulk	PUT /api/v3/customformat/bulk
CustomFormatApi	update_custom_format	PUT /api/v3/customformat/{id}
CutoffApi	get_wanted_cutoff	GET /api/v3/wanted/cutoff
CutoffApi	get_wanted_cutoff_by_id	GET /api/v3/wanted/cutoff/{id}
DelayProfileApi	create_delay_profile	POST /api/v3/delayprofile
DelayProfileApi	delete_delay_profile	DELETE /api/v3/delayprofile/{id}
DelayProfileApi	get_delay_profile_by_id	GET /api/v3/delayprofile/{id}
DelayProfileApi	list_delay_profile	GET /api/v3/delayprofile
DelayProfileApi	update_delay_profile	PUT /api/v3/delayprofile/{id}
DelayProfileApi	update_delay_profile_reorder	PUT /api/v3/delayprofile/reorder/{id}
DiskSpaceApi	list_disk_space	GET /api/v3/diskspace
DownloadClientApi	create_download_client	POST /api/v3/downloadclient
DownloadClientApi	create_download_client_action_by_name	POST /api/v3/downloadclient/action/{name}
DownloadClientApi	delete_download_client	DELETE /api/v3/downloadclient/{id}
DownloadClientApi	delete_download_client_bulk	DELETE /api/v3/downloadclient/bulk
DownloadClientApi	get_download_client_by_id	GET /api/v3/downloadclient/{id}
DownloadClientApi	list_download_client	GET /api/v3/downloadclient
DownloadClientApi	list_download_client_schema	GET /api/v3/downloadclient/schema
DownloadClientApi	put_download_client_bulk	PUT /api/v3/downloadclient/bulk
DownloadClientApi	test_download_client	POST /api/v3/downloadclient/test
DownloadClientApi	testall_download_client	POST /api/v3/downloadclient/testall
DownloadClientApi	update_download_client	PUT /api/v3/downloadclient/{id}
DownloadClientConfigApi	get_download_client_config	GET /api/v3/config/downloadclient
DownloadClientConfigApi	get_download_client_config_by_id	GET /api/v3/config/downloadclient/{id}
DownloadClientConfigApi	update_download_client_config	PUT /api/v3/config/downloadclient/{id}
EpisodeApi	get_episode_by_id	GET /api/v3/episode/{id}
EpisodeApi	list_episode	GET /api/v3/episode
EpisodeApi	put_episode_monitor	PUT /api/v3/episode/monitor
EpisodeApi	update_episode	PUT /api/v3/episode/{id}
EpisodeFileApi	delete_episode_file	DELETE /api/v3/episodefile/{id}
EpisodeFileApi	delete_episode_file_bulk	DELETE /api/v3/episodefile/bulk
EpisodeFileApi	get_episode_file_by_id	GET /api/v3/episodefile/{id}
EpisodeFileApi	list_episode_file	GET /api/v3/episodefile
EpisodeFileApi	put_episode_file_bulk	PUT /api/v3/episodefile/bulk
EpisodeFileApi	put_episode_file_editor	PUT /api/v3/episodefile/editor
EpisodeFileApi	update_episode_file	PUT /api/v3/episodefile/{id}
FileSystemApi	get_file_system	GET /api/v3/filesystem
FileSystemApi	get_file_system_mediafiles	GET /api/v3/filesystem/mediafiles
FileSystemApi	get_file_system_type	GET /api/v3/filesystem/type
HealthApi	list_health	GET /api/v3/health
HistoryApi	create_history_failed_by_id	POST /api/v3/history/failed/{id}
HistoryApi	get_history	GET /api/v3/history
HistoryApi	list_history_series	GET /api/v3/history/series
HistoryApi	list_history_since	GET /api/v3/history/since
HostConfigApi	get_host_config	GET /api/v3/config/host
HostConfigApi	get_host_config_by_id	GET /api/v3/config/host/{id}
HostConfigApi	update_host_config	PUT /api/v3/config/host/{id}
ImportListApi	create_import_list	POST /api/v3/importlist
ImportListApi	create_import_list_action_by_name	POST /api/v3/importlist/action/{name}
ImportListApi	delete_import_list	DELETE /api/v3/importlist/{id}
ImportListApi	delete_import_list_bulk	DELETE /api/v3/importlist/bulk
ImportListApi	get_import_list_by_id	GET /api/v3/importlist/{id}
ImportListApi	list_import_list	GET /api/v3/importlist
ImportListApi	list_import_list_schema	GET /api/v3/importlist/schema
ImportListApi	put_import_list_bulk	PUT /api/v3/importlist/bulk
ImportListApi	test_import_list	POST /api/v3/importlist/test
ImportListApi	testall_import_list	POST /api/v3/importlist/testall
ImportListApi	update_import_list	PUT /api/v3/importlist/{id}
ImportListConfigApi	get_import_list_config	GET /api/v3/config/importlist
ImportListConfigApi	get_import_list_config_by_id	GET /api/v3/config/importlist/{id}
ImportListConfigApi	update_import_list_config	PUT /api/v3/config/importlist/{id}
ImportListExclusionApi	create_import_list_exclusion	POST /api/v3/importlistexclusion
ImportListExclusionApi	delete_import_list_exclusion	DELETE /api/v3/importlistexclusion/{id}
ImportListExclusionApi	delete_import_list_exclusion_bulk	DELETE /api/v3/importlistexclusion/bulk
ImportListExclusionApi	get_import_list_exclusion_by_id	GET /api/v3/importlistexclusion/{id}
ImportListExclusionApi	get_import_list_exclusion_paged	GET /api/v3/importlistexclusion/paged
ImportListExclusionApi	list_import_list_exclusion	GET /api/v3/importlistexclusion
ImportListExclusionApi	update_import_list_exclusion	PUT /api/v3/importlistexclusion/{id}
IndexerApi	create_indexer	POST /api/v3/indexer
IndexerApi	create_indexer_action_by_name	POST /api/v3/indexer/action/{name}
IndexerApi	delete_indexer	DELETE /api/v3/indexer/{id}
IndexerApi	delete_indexer_bulk	DELETE /api/v3/indexer/bulk
IndexerApi	get_indexer_by_id	GET /api/v3/indexer/{id}
IndexerApi	list_indexer	GET /api/v3/indexer
IndexerApi	list_indexer_schema	GET /api/v3/indexer/schema
IndexerApi	put_indexer_bulk	PUT /api/v3/indexer/bulk
IndexerApi	test_indexer	POST /api/v3/indexer/test
IndexerApi	testall_indexer	POST /api/v3/indexer/testall
IndexerApi	update_indexer	PUT /api/v3/indexer/{id}
IndexerConfigApi	get_indexer_config	GET /api/v3/config/indexer
IndexerConfigApi	get_indexer_config_by_id	GET /api/v3/config/indexer/{id}
IndexerConfigApi	update_indexer_config	PUT /api/v3/config/indexer/{id}
IndexerFlagApi	list_indexer_flag	GET /api/v3/indexerflag
LanguageApi	get_language_by_id	GET /api/v3/language/{id}
LanguageApi	list_language	GET /api/v3/language
LanguageProfileApi	create_language_profile	POST /api/v3/languageprofile
LanguageProfileApi	delete_language_profile	DELETE /api/v3/languageprofile/{id}
LanguageProfileApi	get_language_profile_by_id	GET /api/v3/languageprofile/{id}
LanguageProfileApi	list_language_profile	GET /api/v3/languageprofile
LanguageProfileApi	update_language_profile	PUT /api/v3/languageprofile/{id}
LanguageProfileSchemaApi	get_languageprofile_schema	GET /api/v3/languageprofile/schema
LocalizationApi	get_localization	GET /api/v3/localization
LocalizationApi	get_localization_by_id	GET /api/v3/localization/{id}
LocalizationApi	get_localization_language	GET /api/v3/localization/language
LogApi	get_log	GET /api/v3/log
LogFileApi	get_log_file_by_filename	GET /api/v3/log/file/{filename}
LogFileApi	list_log_file	GET /api/v3/log/file
ManualImportApi	create_manual_import	POST /api/v3/manualimport
ManualImportApi	list_manual_import	GET /api/v3/manualimport
MediaCoverApi	get_media_cover_by_filename	GET /api/v3/mediacover/{seriesId}/{filename}
MediaManagementConfigApi	get_media_management_config	GET /api/v3/config/mediamanagement
MediaManagementConfigApi	get_media_management_config_by_id	GET /api/v3/config/mediamanagement/{id}
MediaManagementConfigApi	update_media_management_config	PUT /api/v3/config/mediamanagement/{id}
MetadataApi	create_metadata	POST /api/v3/metadata
MetadataApi	create_metadata_action_by_name	POST /api/v3/metadata/action/{name}
MetadataApi	delete_metadata	DELETE /api/v3/metadata/{id}
MetadataApi	get_metadata_by_id	GET /api/v3/metadata/{id}
MetadataApi	list_metadata	GET /api/v3/metadata
MetadataApi	list_metadata_schema	GET /api/v3/metadata/schema
MetadataApi	test_metadata	POST /api/v3/metadata/test
MetadataApi	testall_metadata	POST /api/v3/metadata/testall
MetadataApi	update_metadata	PUT /api/v3/metadata/{id}
MissingApi	get_wanted_missing	GET /api/v3/wanted/missing
MissingApi	get_wanted_missing_by_id	GET /api/v3/wanted/missing/{id}
NamingConfigApi	get_naming_config	GET /api/v3/config/naming
NamingConfigApi	get_naming_config_by_id	GET /api/v3/config/naming/{id}
NamingConfigApi	get_naming_config_examples	GET /api/v3/config/naming/examples
NamingConfigApi	update_naming_config	PUT /api/v3/config/naming/{id}
NotificationApi	create_notification	POST /api/v3/notification
NotificationApi	create_notification_action_by_name	POST /api/v3/notification/action/{name}
NotificationApi	delete_notification	DELETE /api/v3/notification/{id}
NotificationApi	get_notification_by_id	GET /api/v3/notification/{id}
NotificationApi	list_notification	GET /api/v3/notification
NotificationApi	list_notification_schema	GET /api/v3/notification/schema
NotificationApi	test_notification	POST /api/v3/notification/test
NotificationApi	testall_notification	POST /api/v3/notification/testall
NotificationApi	update_notification	PUT /api/v3/notification/{id}
ParseApi	get_parse	GET /api/v3/parse
PingApi	get_ping	GET /ping
PingApi	head_ping	HEAD /ping
QualityDefinitionApi	get_quality_definition_by_id	GET /api/v3/qualitydefinition/{id}
QualityDefinitionApi	get_quality_definition_limits	GET /api/v3/qualitydefinition/limits
QualityDefinitionApi	list_quality_definition	GET /api/v3/qualitydefinition
QualityDefinitionApi	put_quality_definition_update	PUT /api/v3/qualitydefinition/update
QualityDefinitionApi	update_quality_definition	PUT /api/v3/qualitydefinition/{id}
QualityProfileApi	create_quality_profile	POST /api/v3/qualityprofile
QualityProfileApi	delete_quality_profile	DELETE /api/v3/qualityprofile/{id}
QualityProfileApi	get_quality_profile_by_id	GET /api/v3/qualityprofile/{id}
QualityProfileApi	list_quality_profile	GET /api/v3/qualityprofile
QualityProfileApi	update_quality_profile	PUT /api/v3/qualityprofile/{id}
QualityProfileSchemaApi	get_qualityprofile_schema	GET /api/v3/qualityprofile/schema
QueueApi	delete_queue	DELETE /api/v3/queue/{id}
QueueApi	delete_queue_bulk	DELETE /api/v3/queue/bulk
QueueApi	get_queue	GET /api/v3/queue
QueueActionApi	create_queue_grab_bulk	POST /api/v3/queue/grab/bulk
QueueActionApi	create_queue_grab_by_id	POST /api/v3/queue/grab/{id}
QueueDetailsApi	list_queue_details	GET /api/v3/queue/details
QueueStatusApi	get_queue_status	GET /api/v3/queue/status
ReleaseApi	create_release	POST /api/v3/release
ReleaseApi	list_release	GET /api/v3/release
ReleaseProfileApi	create_release_profile	POST /api/v3/releaseprofile
ReleaseProfileApi	delete_release_profile	DELETE /api/v3/releaseprofile/{id}
ReleaseProfileApi	get_release_profile_by_id	GET /api/v3/releaseprofile/{id}
ReleaseProfileApi	list_release_profile	GET /api/v3/releaseprofile
ReleaseProfileApi	update_release_profile	PUT /api/v3/releaseprofile/{id}
ReleasePushApi	create_release_push	POST /api/v3/release/push
RemotePathMappingApi	create_remote_path_mapping	POST /api/v3/remotepathmapping
RemotePathMappingApi	delete_remote_path_mapping	DELETE /api/v3/remotepathmapping/{id}
RemotePathMappingApi	get_remote_path_mapping_by_id	GET /api/v3/remotepathmapping/{id}
RemotePathMappingApi	list_remote_path_mapping	GET /api/v3/remotepathmapping
RemotePathMappingApi	update_remote_path_mapping	PUT /api/v3/remotepathmapping/{id}
RenameEpisodeApi	list_rename	GET /api/v3/rename
RootFolderApi	create_root_folder	POST /api/v3/rootfolder
RootFolderApi	delete_root_folder	DELETE /api/v3/rootfolder/{id}
RootFolderApi	get_root_folder_by_id	GET /api/v3/rootfolder/{id}
RootFolderApi	list_root_folder	GET /api/v3/rootfolder
SeasonPassApi	create_season_pass	POST /api/v3/seasonpass
SeriesApi	create_series	POST /api/v3/series
SeriesApi	delete_series	DELETE /api/v3/series/{id}
SeriesApi	get_series_by_id	GET /api/v3/series/{id}
SeriesApi	list_series	GET /api/v3/series
SeriesApi	update_series	PUT /api/v3/series/{id}
SeriesEditorApi	delete_series_editor	DELETE /api/v3/series/editor
SeriesEditorApi	put_series_editor	PUT /api/v3/series/editor
SeriesImportApi	create_series_import	POST /api/v3/series/import
SeriesLookupApi	list_series_lookup	GET /api/v3/series/lookup
StaticResourceApi	get	GET /
StaticResourceApi	get_by_path	GET /{path}
StaticResourceApi	get_content_by_path	GET /content/{path}
StaticResourceApi	get_login	GET /login
SystemApi	create_system_restart	POST /api/v3/system/restart
SystemApi	create_system_shutdown	POST /api/v3/system/shutdown
SystemApi	get_system_routes	GET /api/v3/system/routes
SystemApi	get_system_routes_duplicate	GET /api/v3/system/routes/duplicate
SystemApi	get_system_status	GET /api/v3/system/status
TagApi	create_tag	POST /api/v3/tag
TagApi	delete_tag	DELETE /api/v3/tag/{id}
TagApi	get_tag_by_id	GET /api/v3/tag/{id}
TagApi	list_tag	GET /api/v3/tag
TagApi	update_tag	PUT /api/v3/tag/{id}
TagDetailsApi	get_tag_detail_by_id	GET /api/v3/tag/detail/{id}
TagDetailsApi	list_tag_detail	GET /api/v3/tag/detail
TaskApi	get_system_task_by_id	GET /api/v3/system/task/{id}
TaskApi	list_system_task	GET /api/v3/system/task
UiConfigApi	get_ui_config	GET /api/v3/config/ui
UiConfigApi	get_ui_config_by_id	GET /api/v3/config/ui/{id}
UiConfigApi	update_ui_config	PUT /api/v3/config/ui/{id}
UpdateApi	list_update	GET /api/v3/update
UpdateLogFileApi	get_log_file_update_by_filename	GET /api/v3/log/file/update/{filename}
UpdateLogFileApi	list_log_file_update	GET /api/v3/log/file/update

Documentation For Models

• AddSeriesOptions
• AlternateTitleResource
• ApplyTags
• AuthenticationRequiredType
• AuthenticationType
• AutoTaggingResource
• AutoTaggingSpecificationSchema
• BackupResource
• BackupType
• BlocklistBulkResource
• BlocklistResource
• BlocklistResourcePagingResource
• CertificateValidationType
• Command
• CommandPriority
• CommandResource
• CommandResult
• CommandStatus
• CommandTrigger
• ContractField
• CustomFilterResource
• CustomFormatBulkResource
• CustomFormatResource
• CustomFormatSpecificationSchema
• DatabaseType
• DelayProfileResource
• DiskSpaceResource
• DownloadClientBulkResource
• DownloadClientConfigResource
• DownloadClientResource
• DownloadProtocol
• EpisodeFileListResource
• EpisodeFileResource
• EpisodeHistoryEventType
• EpisodeResource
• EpisodeResourcePagingResource
• EpisodeTitleRequiredType
• EpisodesMonitoredResource
• FileDateType
• HealthCheckResult
• HealthResource
• HistoryResource
• HistoryResourcePagingResource
• HostConfigResource
• ImportListBulkResource
• ImportListConfigResource
• ImportListExclusionBulkResource
• ImportListExclusionResource
• ImportListExclusionResourcePagingResource
• ImportListResource
• ImportListType
• IndexerBulkResource
• IndexerConfigResource
• IndexerFlagResource
• IndexerResource
• Language
• LanguageProfileItemResource
• LanguageProfileResource
• LanguageResource
• ListSyncLevelType
• LocalizationLanguageResource
• LocalizationResource
• LogFileResource
• LogResource
• LogResourcePagingResource
• ManualImportReprocessResource
• ManualImportResource
• MediaCover
• MediaCoverTypes
• MediaInfoResource
• MediaManagementConfigResource
• MetadataResource
• MonitorTypes
• MonitoringOptions
• NamingConfigResource
• NewItemMonitorTypes
• NotificationResource
• ParseResource
• ParsedEpisodeInfo
• PingResource
• PrivacyLevel
• ProfileFormatItemResource
• ProperDownloadTypes
• ProviderMessage
• ProviderMessageType
• ProxyType
• Quality
• QualityDefinitionLimitsResource
• QualityDefinitionResource
• QualityModel
• QualityProfileQualityItemResource
• QualityProfileResource
• QualitySource
• QueueBulkResource
• QueueResource
• QueueResourcePagingResource
• QueueStatus
• QueueStatusResource
• Ratings
• Rejection
• RejectionType
• ReleaseEpisodeResource
• ReleaseProfileResource
• ReleaseResource
• ReleaseType
• RemotePathMappingResource
• RenameEpisodeResource
• RescanAfterRefreshType
• Revision
• RootFolderResource
• RuntimeMode
• SeasonPassResource
• SeasonPassSeriesResource
• SeasonResource
• SeasonStatisticsResource
• SelectOption
• SeriesEditorResource
• SeriesResource
• SeriesStatisticsResource
• SeriesStatusType
• SeriesTitleInfo
• SeriesTypes
• SortDirection
• SystemResource
• TagDetailsResource
• TagResource
• TaskResource
• TrackedDownloadState
• TrackedDownloadStatus
• TrackedDownloadStatusMessage
• UiConfigResource
• UnmappedFolder
• UpdateChanges
• UpdateMechanism
• UpdateResource

Documentation For Authorization

Authentication schemes defined for the API:

X-Api-Key

• Type: API key
• API key parameter name: X-Api-Key
• Location: HTTP header

apikey

• Type: API key
• API key parameter name: apikey
• Location: URL query string

Author