prowlarr-py

Prowlarr API docs

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

• API version: v2.7.0.5723
• Package version: 1.1.1
• Generator version: 7.27.0
• Build package: org.openapitools.codegen.languages.PythonClientCodegen

Requirements.

Python 3.11+

Packaging uses standard [project] metadata and [dependency-groups] (PEP 621/735). Install the package with python -m pip install .; install development dependencies with Poetry 2.2 or newer using poetry install, or pip 25.1 or newer using python -m pip install --group dev. The latter installs the group, not the package.

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/prowlarr-py.git

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

Then import the package:

import prowlarr

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 prowlarr

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import prowlarr
from prowlarr.rest import ApiException
from pprint import pprint

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

# 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 prowlarr.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = prowlarr.ApiInfoApi(api_client)

    try:
        api_response = api_instance.get_api()
        print("The response of ApiInfoApi->get_api:\n")
        pprint(api_response)
    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:9696

Class	Method	HTTP request	Description
ApiInfoApi	get_api	GET /api
AppProfileApi	create_app_profile	POST /api/v1/appprofile
AppProfileApi	delete_app_profile	DELETE /api/v1/appprofile/{id}
AppProfileApi	get_app_profile_by_id	GET /api/v1/appprofile/{id}
AppProfileApi	get_app_profile_schema	GET /api/v1/appprofile/schema
AppProfileApi	list_app_profile	GET /api/v1/appprofile
AppProfileApi	update_app_profile	PUT /api/v1/appprofile/{id}
ApplicationApi	create_applications	POST /api/v1/applications
ApplicationApi	create_applications_action_by_name	POST /api/v1/applications/action/{name}
ApplicationApi	delete_applications	DELETE /api/v1/applications/{id}
ApplicationApi	delete_applications_bulk	DELETE /api/v1/applications/bulk
ApplicationApi	get_applications_by_id	GET /api/v1/applications/{id}
ApplicationApi	list_applications	GET /api/v1/applications
ApplicationApi	list_applications_schema	GET /api/v1/applications/schema
ApplicationApi	put_applications_bulk	PUT /api/v1/applications/bulk
ApplicationApi	test_applications	POST /api/v1/applications/test
ApplicationApi	testall_applications	POST /api/v1/applications/testall
ApplicationApi	update_applications	PUT /api/v1/applications/{id}
AuthenticationApi	create_login	POST /login
AuthenticationApi	get_logout	GET /logout
BackupApi	create_system_backup_restore_by_id	POST /api/v1/system/backup/restore/{id}
BackupApi	create_system_backup_restore_upload	POST /api/v1/system/backup/restore/upload
BackupApi	delete_system_backup	DELETE /api/v1/system/backup/{id}
BackupApi	list_system_backup	GET /api/v1/system/backup
CommandApi	create_command	POST /api/v1/command
CommandApi	delete_command	DELETE /api/v1/command/{id}
CommandApi	get_command_by_id	GET /api/v1/command/{id}
CommandApi	list_command	GET /api/v1/command
CustomFilterApi	create_custom_filter	POST /api/v1/customfilter
CustomFilterApi	delete_custom_filter	DELETE /api/v1/customfilter/{id}
CustomFilterApi	get_custom_filter_by_id	GET /api/v1/customfilter/{id}
CustomFilterApi	list_custom_filter	GET /api/v1/customfilter
CustomFilterApi	update_custom_filter	PUT /api/v1/customfilter/{id}
DevelopmentConfigApi	get_development_config	GET /api/v1/config/development
DevelopmentConfigApi	get_development_config_by_id	GET /api/v1/config/development/{id}
DevelopmentConfigApi	update_development_config	PUT /api/v1/config/development/{id}
DownloadClientApi	create_download_client	POST /api/v1/downloadclient
DownloadClientApi	create_download_client_action_by_name	POST /api/v1/downloadclient/action/{name}
DownloadClientApi	delete_download_client	DELETE /api/v1/downloadclient/{id}
DownloadClientApi	delete_download_client_bulk	DELETE /api/v1/downloadclient/bulk
DownloadClientApi	get_download_client_by_id	GET /api/v1/downloadclient/{id}
DownloadClientApi	list_download_client	GET /api/v1/downloadclient
DownloadClientApi	list_download_client_schema	GET /api/v1/downloadclient/schema
DownloadClientApi	put_download_client_bulk	PUT /api/v1/downloadclient/bulk
DownloadClientApi	test_download_client	POST /api/v1/downloadclient/test
DownloadClientApi	testall_download_client	POST /api/v1/downloadclient/testall
DownloadClientApi	update_download_client	PUT /api/v1/downloadclient/{id}
DownloadClientConfigApi	get_download_client_config	GET /api/v1/config/downloadclient
DownloadClientConfigApi	get_download_client_config_by_id	GET /api/v1/config/downloadclient/{id}
DownloadClientConfigApi	update_download_client_config	PUT /api/v1/config/downloadclient/{id}
FileSystemApi	get_file_system	GET /api/v1/filesystem
FileSystemApi	get_file_system_type	GET /api/v1/filesystem/type
HealthApi	list_health	GET /api/v1/health
HistoryApi	get_history	GET /api/v1/history
HistoryApi	list_history_indexer	GET /api/v1/history/indexer
HistoryApi	list_history_since	GET /api/v1/history/since
HostConfigApi	get_host_config	GET /api/v1/config/host
HostConfigApi	get_host_config_by_id	GET /api/v1/config/host/{id}
HostConfigApi	update_host_config	PUT /api/v1/config/host/{id}
IndexerApi	create_indexer	POST /api/v1/indexer
IndexerApi	create_indexer_action_by_name	POST /api/v1/indexer/action/{name}
IndexerApi	delete_indexer	DELETE /api/v1/indexer/{id}
IndexerApi	delete_indexer_bulk	DELETE /api/v1/indexer/bulk
IndexerApi	get_indexer_by_id	GET /api/v1/indexer/{id}
IndexerApi	list_indexer	GET /api/v1/indexer
IndexerApi	list_indexer_schema	GET /api/v1/indexer/schema
IndexerApi	put_indexer_bulk	PUT /api/v1/indexer/bulk
IndexerApi	test_indexer	POST /api/v1/indexer/test
IndexerApi	testall_indexer	POST /api/v1/indexer/testall
IndexerApi	update_indexer	PUT /api/v1/indexer/{id}
IndexerDefaultCategoriesApi	list_indexer_categories	GET /api/v1/indexer/categories
IndexerProxyApi	create_indexer_proxy	POST /api/v1/indexerproxy
IndexerProxyApi	create_indexer_proxy_action_by_name	POST /api/v1/indexerproxy/action/{name}
IndexerProxyApi	delete_indexer_proxy	DELETE /api/v1/indexerproxy/{id}
IndexerProxyApi	get_indexer_proxy_by_id	GET /api/v1/indexerproxy/{id}
IndexerProxyApi	list_indexer_proxy	GET /api/v1/indexerproxy
IndexerProxyApi	list_indexer_proxy_schema	GET /api/v1/indexerproxy/schema
IndexerProxyApi	test_indexer_proxy	POST /api/v1/indexerproxy/test
IndexerProxyApi	testall_indexer_proxy	POST /api/v1/indexerproxy/testall
IndexerProxyApi	update_indexer_proxy	PUT /api/v1/indexerproxy/{id}
IndexerStatsApi	get_indexer_stats	GET /api/v1/indexerstats
IndexerStatusApi	list_indexer_status	GET /api/v1/indexerstatus
LocalizationApi	get_localization	GET /api/v1/localization
LocalizationApi	list_localization_options	GET /api/v1/localization/options
LogApi	get_log	GET /api/v1/log
LogFileApi	get_log_file_by_filename	GET /api/v1/log/file/{filename}
LogFileApi	list_log_file	GET /api/v1/log/file
NewznabApi	get_indexer_download	GET /api/v1/indexer/{id}/download
NewznabApi	get_indexer_newznab	GET /api/v1/indexer/{id}/newznab
NotificationApi	create_notification	POST /api/v1/notification
NotificationApi	create_notification_action_by_name	POST /api/v1/notification/action/{name}
NotificationApi	delete_notification	DELETE /api/v1/notification/{id}
NotificationApi	get_notification_by_id	GET /api/v1/notification/{id}
NotificationApi	list_notification	GET /api/v1/notification
NotificationApi	list_notification_schema	GET /api/v1/notification/schema
NotificationApi	test_notification	POST /api/v1/notification/test
NotificationApi	testall_notification	POST /api/v1/notification/testall
NotificationApi	update_notification	PUT /api/v1/notification/{id}
PingApi	get_ping	GET /ping
PingApi	head_ping	HEAD /ping
SearchApi	create_search	POST /api/v1/search
SearchApi	create_search_bulk	POST /api/v1/search/bulk
SearchApi	list_search	GET /api/v1/search
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/v1/system/restart
SystemApi	create_system_shutdown	POST /api/v1/system/shutdown
SystemApi	get_system_routes	GET /api/v1/system/routes
SystemApi	get_system_routes_duplicate	GET /api/v1/system/routes/duplicate
SystemApi	get_system_status	GET /api/v1/system/status
TagApi	create_tag	POST /api/v1/tag
TagApi	delete_tag	DELETE /api/v1/tag/{id}
TagApi	get_tag_by_id	GET /api/v1/tag/{id}
TagApi	list_tag	GET /api/v1/tag
TagApi	update_tag	PUT /api/v1/tag/{id}
TagDetailsApi	get_tag_detail_by_id	GET /api/v1/tag/detail/{id}
TagDetailsApi	list_tag_detail	GET /api/v1/tag/detail
TaskApi	get_system_task_by_id	GET /api/v1/system/task/{id}
TaskApi	list_system_task	GET /api/v1/system/task
UiConfigApi	get_ui_config	GET /api/v1/config/ui
UiConfigApi	get_ui_config_by_id	GET /api/v1/config/ui/{id}
UiConfigApi	update_ui_config	PUT /api/v1/config/ui/{id}
UpdateApi	list_update	GET /api/v1/update
UpdateLogFileApi	get_log_file_update_by_filename	GET /api/v1/log/file/update/{filename}
UpdateLogFileApi	list_log_file_update	GET /api/v1/log/file/update

Documentation For Models

• ApiInfoResource
• AppProfileResource
• ApplicationBulkResource
• ApplicationResource
• ApplicationSyncLevel
• ApplyTags
• AuthenticationRequiredType
• AuthenticationType
• BackupResource
• BackupType
• BookSearchParam
• CertificateValidationType
• Command
• CommandPriority
• CommandResource
• CommandStatus
• CommandTrigger
• ContractField
• CustomFilterResource
• DatabaseType
• DevelopmentConfigResource
• DownloadClientBulkResource
• DownloadClientCategory
• DownloadClientConfigResource
• DownloadClientResource
• DownloadProtocol
• HealthCheckResult
• HealthResource
• HistoryEventType
• HistoryResource
• HistoryResourcePagingResource
• HostConfigResource
• HostStatistics
• IndexerBulkResource
• IndexerCapabilityResource
• IndexerCategory
• IndexerPrivacy
• IndexerProxyResource
• IndexerResource
• IndexerStatistics
• IndexerStatsResource
• IndexerStatusResource
• LocalizationOption
• LogFileResource
• LogResource
• LogResourcePagingResource
• MovieSearchParam
• MusicSearchParam
• NotificationResource
• PingResource
• PrivacyLevel
• ProviderMessage
• ProviderMessageType
• ProxyType
• ReleaseResource
• RuntimeMode
• SearchParam
• SelectOption
• SortDirection
• SystemResource
• TagDetailsResource
• TagResource
• TaskResource
• TvSearchParam
• UiConfigResource
• UpdateChanges
• UpdateMechanism
• UpdateResource
• UserAgentStatistics

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

Request headers

Header names are compared case-insensitively in all Python client libraries. Request headers are copied; supplying _headers does not change the caller's dict or the client's shared defaults. The public _headers argument retains its dict validation and existing value serialization. Pydantic can coerce mappings such as HTTPX Headers to a dict, combining repeated fields into a single value; _headers does not provide a repeated-field or list-of-pairs API.

Precedence, from lowest to highest:

1. _headers (within one dict, the last inserted case variant wins).
2. Explicit OpenAPI header parameters and generated Content-Type (or _content_type). Generated Accept is added only when neither _headers nor explicit header parameters contain an Accept case variant.
3. ApiClient.default_headers (including headers set with set_default_header).
4. The client's cookie setting, for Cookie.
5. Authentication headers. A non-empty _request_auth replaces configured authentication for that call; {} retains configured authentication. Cookie authentication appends to the selected Cookie value.

This retains the existing precedence for identically spelled names and extends it to case variants. To override a generated content type, use _content_type; client defaults still take precedence over it. The winning header's spelling and value are retained for replacements. Cookie authentication uses the canonical Cookie spelling and appends its value. Values containing legitimate comma-separated lists are not split or deduplicated. This does not remove duplicate values inside a header or change the handling of repeated fields supplied directly to the transport.