info: description: Documentation for the Unmanic application API title: Unmanic API version: '2' servers: - url: http://localhost:8888/unmanic/api/v2/ description: Local environment components: securitySchemes: BasicAuth: type: http scheme: basic schemas: DocumentContentSuccess: type: object properties: content: type: array minItems: 1 description: Document contents read line-by-line into a list example: - 'First line ' - 'Second line ' - ' ' items: type: string required: - content BadRequest: type: object properties: error: type: string description: Return status code and reason example: '400: Failed request schema validation' messages: type: object description: Attached request body validation errors example: &id001 name: - The thing that went wrong. traceback: type: array description: Attached exception traceback (if developer mode is enabled) example: &id002 - 'Traceback (most recent call last): ' - '...' - 'json.decoder.JSONDecodeError: Expecting value: line 3 column 14 (char 45) ' items: type: string required: - error - messages BadEndpoint: type: object properties: error: type: string description: Return status code and reason example: '404: Endpoint not found' required: - error BadMethod: type: object properties: error: type: string description: Return status code and reason example: '405: Method ''GET'' not allowed' required: - error InternalError: type: object properties: error: type: string description: Return status code and reason example: '500: Caught exception message' messages: type: object description: Attached request body validation errors example: *id001 traceback: type: array description: Attached exception traceback (if developer mode is enabled) example: *id002 items: type: string required: - error - messages RequestDirectoryListingData: type: object properties: current_path: type: string default: / example: / list_type: type: string default: all example: directories DirectoryListingResults: type: object properties: directories: type: array minItems: 0 description: A list of directories in the given path example: - value: home label: /home - value: tmp label: /tmp items: type: object files: type: array minItems: 0 description: A list of files in the given path example: - value: file1.txt label: /file1.txt - value: file2.txt label: /file2.txt items: type: object required: - directories - files RequestHistoryTableData: type: object properties: start: type: integer default: 0 description: Start row number to select from example: 0 length: type: integer default: 10 description: Number of rows to select example: 10 search_value: type: string default: '' description: String to filter search results by example: items with this text in the value status: type: string default: all description: Filter on the status example: all after: type: string format: date-time nullable: true description: Filter entries since datetime example: 2022-04-07 01:45 before: type: string format: date-time nullable: true description: Filter entries prior to datetime example: 2022-04-07 01:55 order_by: type: string default: finish_time example: finish_time order_direction: type: string enum: - asc - desc description: Order direction ('asc' or 'desc') example: desc CompletedTasksTableResults: type: object properties: id: type: integer description: Item ID example: 1 task_label: type: string description: Item label example: example.mp4 task_success: type: boolean description: Item success status example: true finish_time: type: integer description: Item finish time example: 1627392616.6400812 required: - finish_time - id - task_label - task_success CompletedTasks: type: object properties: recordsTotal: type: integer description: Total number of records in this table example: 329 recordsFiltered: type: integer default: 10 description: Total number of records after filters have been applied example: 10 results: minItems: 0 description: Results type: array items: $ref: '#/components/schemas/CompletedTasksTableResults' successCount: type: integer description: Total count of times with a success status in the results list example: 337 failedCount: type: integer description: Total count of times with a failed status in the results list example: 2 required: - failedCount - results - successCount RequestTableUpdateByIdList: type: object properties: id_list: type: array minItems: 1 description: List of table IDs example: &id003 [] items: type: integer required: - id_list BaseSuccess: type: object properties: success: type: boolean description: This is always "True" when a request succeeds example: true required: - success RequestAddCompletedToPendingTasks: type: object properties: id_list: type: array minItems: 1 description: List of table IDs example: *id003 items: type: integer library_id: type: integer default: 0 example: 1 required: - id_list CompletedTasksLogRequest: type: object properties: task_id: type: integer description: The ID of the task example: 1 required: - task_id CompletedTasksLog: type: object properties: command_log: type: string description: Long string... example: Long string... command_log_lines: type: array description: The long string broken up into an array of lines example: - '' - 'RUNNER: ' - 'Video Encoder H264 - libx264 [Pass #1]' - '' - COMMAND: - '' - '...' items: type: string required: - command_log - command_log_lines NotificationData: type: object properties: uuid: type: string description: Unique ID for this notification example: updateAvailable type: type: string description: The type of notification example: info icon: type: string description: The icon to display with the notification example: update label: type: string description: The label of the notification. Can be a I18n key or a string example: updateAvailableLabel message: type: string description: The message of the notification. Can be a I18n key or a string example: updateAvailableMessage navigation: type: object description: The navigation links of the notification example: url: https://docs.unmanic.app required: - icon - label - message - navigation - type - uuid RequestNotificationsData: type: object properties: notifications: minItems: 0 description: List of notifications type: array items: $ref: '#/components/schemas/NotificationData' required: - notifications RequestTableUpdateByUuidList: type: object properties: uuid_list: type: array minItems: 1 description: List of table UUIDs example: [] items: type: string required: - uuid_list RequestPendingTableData: type: object properties: start: type: integer default: 0 description: Start row number to select from example: 0 length: type: integer default: 10 description: Number of rows to select example: 10 search_value: type: string default: '' description: String to filter search results by example: items with this text in the value status: type: string default: all description: Filter on the status example: all after: type: string format: date-time nullable: true description: Filter entries since datetime example: 2022-04-07 01:45 before: type: string format: date-time nullable: true description: Filter entries prior to datetime example: 2022-04-07 01:55 order_by: type: string default: priority example: priority order_direction: type: string enum: - asc - desc description: Order direction ('asc' or 'desc') example: desc PendingTasksTableResults: type: object properties: id: type: integer description: Item ID example: 1 abspath: type: string description: File absolute path example: example.mp4 priority: type: integer description: The current priority (higher is greater) example: 100 type: type: string description: The type of the pending task - local or remote example: local status: type: string description: The current status of the pending task example: pending checksum: type: string description: The uploaded file md5 checksum example: 5425ab3df5cdbad2e1099bb4cb963a4f library_id: type: integer description: The ID of the library for which this task was created example: 1 library_name: type: string description: The name of the library for which this task was created example: Default required: - abspath - id - priority - status - type PendingTasks: type: object properties: recordsTotal: type: integer description: Total number of records in this table example: 329 recordsFiltered: type: integer default: 10 description: Total number of records after filters have been applied example: 10 results: minItems: 0 description: Results type: array items: $ref: '#/components/schemas/PendingTasksTableResults' required: - results RequestPendingTasksReorder: type: object properties: id_list: type: array minItems: 1 description: List of table IDs example: *id003 items: type: integer position: type: string enum: - top - bottom description: Position to move given list of items to ('top' or 'bottom') example: top required: - id_list - position RequestPendingTaskCreate: type: object properties: path: type: string description: The absolute path to a file example: /library/TEST_FILE.mkv library_id: type: integer description: The ID of the library to append this task to example: 1 library_name: type: string description: The name of the library to append this task to example: Default type: type: string description: The type of pending task to create (local/remote) example: local priority_score: type: integer description: Apply a priority score to the created task to either increase or decrease its position in the queue example: 1000 required: - path RequestPendingTasksLibraryUpdate: type: object properties: id_list: type: array minItems: 1 description: List of table IDs example: *id003 items: type: integer library_name: type: string example: Default required: - id_list - library_name TaskDownloadLink: type: object properties: link_id: type: string description: The ID used to download the file /unmanic/downloads/{link_id} example: 2960645c-a4e2-4b05-8866-7bd469ee9ef8 required: - link_id RequestPluginsTableData: type: object properties: start: type: integer default: 0 description: Start row number to select from example: 0 length: type: integer default: 10 description: Number of rows to select example: 10 search_value: type: string default: '' description: String to filter search results by example: items with this text in the value status: type: string default: all description: Filter on the status example: all after: type: string format: date-time nullable: true description: Filter entries since datetime example: 2022-04-07 01:45 before: type: string format: date-time nullable: true description: Filter entries prior to datetime example: 2022-04-07 01:55 order_by: type: string default: name example: name order_direction: type: string enum: - asc - desc description: Order direction ('asc' or 'desc') example: desc PluginStatus: type: object properties: installed: type: boolean description: Is the plugin installed example: true update_available: type: boolean description: Does the plugin have an update available example: true PluginsTableResults: type: object properties: plugin_id: type: string description: The plugin ID example: encoder_video_h264_nvenc name: type: string description: The plugin name example: Video Encoder H264 - h264_nvenc author: type: string description: The plugin author example: encoder_video_h264_nvenc description: type: string description: The plugin description example: Ensure all video streams are encoded with the H264 codec using the h264_nvenc encoder. version: type: string description: The plugin version example: Josh.5 icon: type: string description: The plugin icon example: https://raw.githubusercontent.com/Josh5/unmanic-plugins/master/source/encoder_video_h264_nvenc/icon.png tags: type: string description: The plugin tags example: video,encoder,ffmpeg,worker,nvenc,nvdec,nvidia status: description: The plugin status allOf: - $ref: '#/components/schemas/PluginStatus' changelog: type: string description: The plugin changelog example: "[b][color=56adda]0.0.1[/color][/b]\u2022 initial version" has_config: type: boolean description: The plugin has the ability to be configured example: true id: type: integer description: Item table ID example: 1 required: - author - description - icon - id - name - plugin_id - status - tags - version PluginsData: type: object properties: recordsTotal: type: integer description: Total number of records in this table example: 329 recordsFiltered: type: integer default: 10 description: Total number of records after filters have been applied example: 10 results: minItems: 0 description: Results type: array items: $ref: '#/components/schemas/PluginsTableResults' required: - results RequestPluginsInfo: type: object properties: plugin_id: type: string example: encoder_video_hevc_vaapi repo_id: type: string description: The ID of the repository that this plugin is in example: '158899500680826593283708490873332175078' prefer_local: type: boolean default: true example: true library_id: type: integer default: 0 example: 1 required: - plugin_id PluginsConfigInputItem: type: object properties: key_id: type: string description: The config input base64 encoded key (used for linking keys containing spaces, etc.) example: c8f122656ed2acabde9b57101a4c8ec7 key: type: string description: The config input key or name example: downmix_dts_hd_ma value: description: The current value of this config input example: false input_type: type: string description: The config input type example: checkbox label: type: string description: The label used to define this config input example: Downmix DTS-HD Master Audio (max 5.1 channels)? description: type: string nullable: true description: Description of input field example: 'Will automatically downmix DTS-HD Master Audio to 5.1 channels ' tooltip: type: string nullable: true description: Description of input field example: 'Will automatically downmix DTS-HD Master Audio to 5.1 channels ' select_options: type: array description: Additional options if the input_type is set to 'select' example: - value: first label: First Option - value: second label: Second Option items: type: object slider_options: type: object description: Additional options if the input_type is set to 'slider' example: min: 1 max: 8 suffix: M display: type: string description: Should the setting input be displayed (visible, hidden) example: visible sub_setting: type: boolean description: Should the setting be a nested sub-setting field example: false required: - description - display - input_type - key - key_id - label - select_options - slider_options - sub_setting - tooltip - value PluginsInfoResults: type: object properties: plugin_id: type: string description: The plugin ID example: encoder_video_h264_nvenc name: type: string description: The plugin name example: Video Encoder H264 - h264_nvenc author: type: string description: The plugin author example: encoder_video_h264_nvenc description: type: string description: The plugin description example: Ensure all video streams are encoded with the H264 codec using the h264_nvenc encoder. version: type: string description: The plugin version example: Josh.5 icon: type: string description: The plugin icon example: https://raw.githubusercontent.com/Josh5/unmanic-plugins/master/source/encoder_video_h264_nvenc/icon.png tags: type: string description: The plugin tags example: video,encoder,ffmpeg,worker,nvenc,nvdec,nvidia status: description: The plugin status allOf: - $ref: '#/components/schemas/PluginStatus' changelog: type: string description: The plugin changelog example: "[b][color=56adda]0.0.1[/color][/b]\u2022 initial version" has_config: type: boolean description: The plugin has the ability to be configured example: true settings: description: The plugin settings type: array items: $ref: '#/components/schemas/PluginsConfigInputItem' required: - author - description - icon - name - plugin_id - status - tags - version RequestPluginsSettingsSave: type: object properties: plugin_id: type: string example: encoder_video_hevc_vaapi settings: description: The plugin settings type: array items: $ref: '#/components/schemas/PluginsConfigInputItem' library_id: type: integer default: 0 example: 1 required: - plugin_id - settings RequestPluginsSettingsReset: type: object properties: plugin_id: type: string example: encoder_video_hevc_vaapi library_id: type: integer default: 0 example: 1 required: - plugin_id PluginsMetadataInstallableResults: type: object properties: plugin_id: type: string description: The plugin ID example: encoder_video_h264_nvenc name: type: string description: The plugin name example: Video Encoder H264 - h264_nvenc author: type: string description: The plugin author example: encoder_video_h264_nvenc description: type: string description: The plugin description example: Ensure all video streams are encoded with the H264 codec using the h264_nvenc encoder. version: type: string description: The plugin version example: Josh.5 icon: type: string description: The plugin icon example: https://raw.githubusercontent.com/Josh5/unmanic-plugins/master/source/encoder_video_h264_nvenc/icon.png tags: type: string description: The plugin tags example: video,encoder,ffmpeg,worker,nvenc,nvdec,nvidia status: description: The plugin status allOf: - $ref: '#/components/schemas/PluginStatus' changelog: type: string description: The plugin changelog example: "[b][color=56adda]0.0.1[/color][/b]\u2022 initial version" has_config: type: boolean description: The plugin has the ability to be configured example: true package_url: type: string description: The plugin package download URL example: https://raw.githubusercontent.com/Unmanic/unmanic-plugins/repo/plugin_id/plugin_id-1.0.0.zip changelog_url: type: string description: The plugin package download URL example: https://raw.githubusercontent.com/Unmanic/unmanic-plugins/repo/plugin_id/changelog.md repo_name: type: string description: The name of the repository that this plugin is in example: Official Repo repo_id: type: string description: The ID of the repository that this plugin is in example: '158899500680826593283708490873332175078' required: - author - description - icon - name - plugin_id - status - tags - version PluginsInstallableResults: type: object properties: plugins: minItems: 0 description: Results type: array items: $ref: '#/components/schemas/PluginsMetadataInstallableResults' required: - plugins RequestPluginsById: type: object properties: plugin_id: type: string example: encoder_video_hevc_vaapi repo_id: type: string description: The ID of the repository that this plugin is in example: '158899500680826593283708490873332175078' required: - plugin_id RequestPluginsFlowByPluginType: type: object properties: plugin_type: type: string example: library_management.file_test library_id: type: integer default: 1 example: 1 required: - plugin_type PluginTypesResults: type: object properties: results: type: array description: List of Plugin Type IDs supported by this installation example: - library_management.file_test - postprocessor.file_move - postprocessor.task_result - worker.process_item items: type: string required: - results PluginFlowDataResults: type: object properties: plugin_id: type: string description: The plugin ID example: encoder_video_h264_nvenc name: type: string description: The plugin name example: Video Encoder H264 - h264_nvenc author: type: string description: The plugin author example: encoder_video_h264_nvenc description: type: string description: The plugin description example: Ensure all video streams are encoded with the H264 codec using the h264_nvenc encoder. version: type: string description: The plugin version example: Josh.5 icon: type: string description: The plugin icon example: https://raw.githubusercontent.com/Josh5/unmanic-plugins/master/source/encoder_video_h264_nvenc/icon.png required: - author - description - icon - name - plugin_id - version RequestSavingPluginsFlowByPluginType: type: object properties: plugin_type: type: string example: library_management.file_test library_id: type: integer default: 1 example: 1 plugin_flow: minItems: 1 description: Saved flow type: array items: $ref: '#/components/schemas/PluginFlowDataResults' required: - plugin_flow - plugin_type RequestUpdatePluginReposList: type: object properties: repos_list: type: array minItems: 0 description: A list of repost to save example: - https://raw.githubusercontent.com/Josh5/unmanic-plugins/repo/repo.json items: type: string required: - repos_list PluginReposMetadataResults: type: object properties: id: type: string description: The plugin repo ID example: repository.josh5 name: type: string description: The plugin repo name example: Josh.5 Development Plugins for Unmanic icon: type: string description: The plugin repo icon example: https://raw.githubusercontent.com/Josh5/unmanic-plugins/master/icon.png path: type: string description: The plugin repo URL path example: https://raw.githubusercontent.com/Josh5/unmanic-plugins/repo/repo.json required: - icon - id - name - path PluginReposListResults: type: object properties: repos: minItems: 0 description: Results type: array items: $ref: '#/components/schemas/PluginReposMetadataResults' required: - repos PluginsDataPanelTypesData: type: object properties: results: minItems: 0 description: Results type: array items: $ref: '#/components/schemas/PluginFlowDataResults' required: - results SessionStateSuccess: type: object properties: level: type: integer description: User level example: 0 picture_uri: type: string description: User picture example: https://c8.patreon.com/2/200/561356054 name: type: string description: User name example: ExampleUsername123 email: type: string description: User email example: example@gmail.com created: type: number description: Session time created example: 1627793093.676484 uuid: type: string description: Installation uuid example: b429fcc7-9ce1-bcb3-2b8a-b094747f226e required: - level - uuid SettingsReadAndWrite: type: object properties: settings: type: object description: The current settings example: ui_port: 8888 debugging: false library_path: /library enable_library_scanner: false schedule_full_scan_minutes: 1440 follow_symlinks: true run_full_scan_on_start: false cache_path: /tmp/unmanic required: - settings SettingsSystemConfig: type: object properties: configuration: type: object description: The current system configuration example: {} required: - configuration RequestSettingsRemoteInstallationAddressValidation: type: object properties: address: type: string description: The address of the remote installation example: 192.168.1.2:8888 auth: type: string nullable: true description: Authentication type example: Basic username: type: string nullable: true description: An optional username example: foo password: type: string nullable: true description: An optional password example: bar required: - address SettingsRemoteInstallationData: type: object properties: installation: type: object description: The data from the remote installation example: {} required: - installation WorkerEventScheduleResults: type: object properties: repetition: type: string description: '' example: daily schedule_task: type: string description: The type of task. ['count', 'pause', 'resume'] example: count schedule_time: type: string description: '' example: The time when the task should be executed on schedule_worker_count: type: integer description: The worker count to set (only valid if schedule_task is count) example: 4 required: - repetition - schedule_task - schedule_time SettingsWorkerGroupConfig: type: object properties: id: type: integer nullable: true description: '' example: 1 locked: type: boolean description: If the worker group is locked and cannot be deleted example: false name: type: string description: The name of the worker group example: Default Group number_of_workers: type: integer description: The number of workers in this group example: 3 worker_event_schedules: minItems: 0 description: Any scheduled evenets for this worker group type: array items: $ref: '#/components/schemas/WorkerEventScheduleResults' tags: type: array description: A list of tags associated with this worker example: - GPU - priority items: type: string required: - id - locked - name - number_of_workers - tags - worker_event_schedules WorkerGroupsList: type: object properties: worker_groups: minItems: 0 description: Results type: array items: $ref: '#/components/schemas/SettingsWorkerGroupConfig' required: - worker_groups RequestDatabaseItemById: type: object properties: id: type: integer description: The ID of the table item example: 1 required: - id RequestRemoteInstallationLinkConfig: type: object properties: uuid: type: string description: The uuid of the remote installation example: 7cd35429-76ab-4a29-8649-8c91236b5f8b required: - uuid SettingsRemoteInstallationLinkConfig: type: object properties: link_config: type: object description: The configuration for the remote installation link example: address: 10.0.0.2:8888 auth: None username: '' password: '' available: true name: API schema generated version: 0.1.3 last_updated: 1636166593.013826 enable_receiving_tasks: false enable_sending_tasks: false enable_task_preloading: true enable_distributed_worker_count: false preloading_count: 2 enable_checksum_validation: false enable_config_missing_libraries: false distributed_worker_count_target: type: integer description: The target count of workers to be distributed across any configured linked installations example: 4 required: - link_config LibraryResults: type: object properties: id: type: integer description: '' example: 1 name: type: string description: The name of the library example: Default path: type: string description: The library path example: /library locked: type: boolean description: If the library is locked and cannot be deleted example: false enable_remote_only: type: boolean description: If the library is configured for remote files only example: false enable_scanner: type: boolean description: If the library is configured to execute library scans example: false enable_inotify: type: boolean description: If the library is configured to monitor for file changes example: false tags: type: array description: A list of tags associated with this library example: - GPU - priority items: type: string required: - enable_inotify - enable_remote_only - enable_scanner - id - locked - name - path - tags SettingsLibrariesList: type: object properties: libraries: minItems: 1 description: Results type: array items: $ref: '#/components/schemas/LibraryResults' required: - libraries RequestLibraryById: type: object properties: id: type: integer description: The ID of the library example: 1 required: - id SettingsLibraryConfigReadAndWrite: type: object properties: library_config: type: object description: The library configuration example: id: 1 name: Default path: /library enable_scanner: false enable_inotify: false priority_score: 0 tags: [] plugins: type: object description: The library's enabled plugins example: enabled_plugins: - library_id: 1 plugin_id: notify_plex name: Notify Plex description: Notify Plex on completion of a task. icon: https://raw.githubusercontent.com/Josh5/unmanic.plugin.notify_plex/master/icon.png required: - library_config SettingsLibraryPluginConfigExport: type: object properties: plugins: type: object description: The library's enabled plugins example: &id004 enabled_plugins: - library_id: 1 plugin_id: encoder_audio_ac3 name: Audio Encoder AC3 description: Ensure all audio streams are encoded with the AC3 codec using the native FFmpeg ac3 encoder. icon: https://raw.githubusercontent.com/Josh5/unmanic.plugin.encoder_audio_ac3/master/icon.png plugin_flow: library_management.file_test: - plugin_id: encoder_audio_ac3 name: Audio Encoder AC3 author: Josh.5 description: Ensure all audio streams are encoded with the AC3 codec using the native FFmpeg ac3 encoder. version: 0.0.2 icon: https://raw.githubusercontent.com/Josh5/unmanic.plugin.encoder_audio_ac3/master/icon.png worker.process_item: - plugin_id: encoder_audio_ac3 name: Audio Encoder AC3 author: Josh.5 description: Ensure all audio streams are encoded with the AC3 codec using the native FFmpeg ac3 encoder. version: 0.0.2 icon: https://raw.githubusercontent.com/Josh5/unmanic.plugin.encoder_audio_ac3/master/icon.png postprocessor.file_move: [] postprocessor.task_result: [] library_config: type: object description: The library configuration example: &id005 id: 1 name: Default path: /library enable_scanner: false enable_inotify: false priority_score: 0 tags: [] required: - plugins SettingsLibraryPluginConfigImport: type: object properties: plugins: type: object description: The library's enabled plugins example: *id004 library_config: type: object description: The library configuration example: *id005 library_id: type: integer example: 1 required: - library_id - plugins VersionReadSuccess: type: object properties: version: type: string description: Application version example: 1.0.0 required: - version RequestWorkerById: type: object properties: worker_id: type: string example: '1' required: - worker_id WorkerStatusResults: type: object properties: id: type: string description: '' example: W0 name: type: string description: '' example: Worker-W0 idle: type: boolean description: Flag - is worker idle example: true paused: type: boolean description: Flag - is worker paused example: false start_time: type: string nullable: true description: The time when this worker started processing a task example: '1635746377.0021548' current_file: type: string description: The basename of the file currently being processed example: file.mp4 current_task: type: integer nullable: true description: The Task ID example: 1 worker_log_tail: type: array minItems: 0 description: The log lines produced by the worker example: - "\n\nRUNNER: \nRemux Video Files [Pass #1]\n\n" - ' Executing plugin runner... Please wait' - ' Runner did not request to execute a command' - ' No Plugin requested to run commands for this file ''/tmp/unmanic/unmanic_remote_pending_library-1635746225.3336523/file.mp4''' items: type: string runners_info: type: object description: The status of the plugin runner currently processing the file example: video_remuxer: plugin_id: video_remuxer status: complete name: Remux Video Files author: Josh.5 version: 0.0.5 icon: https://raw.githubusercontent.com/Josh5/unmanic.plugin.video_remuxer/master/icon.png description: Remux a video file to the configured container success: true subprocess: type: object description: The status of the process currently being executed example: pid: 140408939493120 percent: None elapsed: None required: - current_file - current_task - id - idle - name - paused - runners_info - start_time - subprocess - worker_log_tail WorkerStatusSuccess: type: object properties: workers_status: minItems: 0 description: Results type: array items: $ref: '#/components/schemas/WorkerStatusResults' required: - workers_status security: - BasicAuth: [] paths: /docs/privacypolicy: get: description: Returns the privacy policy. responses: '200': description: 'Sample response: Returns the privacy policy.' content: application/json: schema: $ref: '#/components/schemas/DocumentContentSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /docs/logs/zip: get: description: Returns the all log files as zip. responses: '200': description: 'Sample response: Returns the all log files as zip.' content: application/octet-stream: schema: type: string format: binary '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /filebrowser/list: post: description: Returns a list of files and/or subdirectories in a given directory. requestBody: description: Requested a list of files and/or subdirectories in a given directory. required: true content: application/json: schema: $ref: '#/components/schemas/RequestDirectoryListingData' responses: '200': description: 'Sample response: Returns a list of files and/or subdirectories in a given directory.' content: application/json: schema: $ref: '#/components/schemas/DirectoryListingResults' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /history/tasks: post: description: Returns a list of completed tasks. requestBody: description: Returns a list of completed tasks. required: true content: application/json: schema: $ref: '#/components/schemas/RequestHistoryTableData' responses: '200': description: 'Sample response: Returns a list of completed tasks.' content: application/json: schema: $ref: '#/components/schemas/CompletedTasks' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' delete: description: Delete a list of completed tasks. requestBody: description: Requested list of items to delete. required: true content: application/json: schema: $ref: '#/components/schemas/RequestTableUpdateByIdList' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /history/reprocess: post: description: Add a list of completed tasks back to the Pending Tasks queue. requestBody: description: Requested list of items to reprocess. required: true content: application/json: schema: $ref: '#/components/schemas/RequestAddCompletedToPendingTasks' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /history/task/log: post: description: Request the details of a completed task. requestBody: description: Requested the details of a completed task. required: true content: application/json: schema: $ref: '#/components/schemas/CompletedTasksLogRequest' responses: '200': description: 'Success: The details of a requested completed task.' content: application/json: schema: $ref: '#/components/schemas/CompletedTasksLog' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /notifications/read: get: description: Returns a list of notifications in reverse chronological order. responses: '200': description: 'Sample response: A list of notifications in reverse chronological order.' content: application/json: schema: $ref: '#/components/schemas/RequestNotificationsData' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /notifications/remove: delete: description: Delete one or all notifications. requestBody: description: Requested list of items to delete. required: true content: application/json: schema: $ref: '#/components/schemas/RequestTableUpdateByUuidList' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /pending/tasks: post: description: Returns a list of pending tasks. requestBody: description: Returns a list of pending tasks. required: true content: application/json: schema: $ref: '#/components/schemas/RequestPendingTableData' responses: '200': description: 'Sample response: Returns a list of pending tasks.' content: application/json: schema: $ref: '#/components/schemas/PendingTasks' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' delete: description: Delete a list of pending tasks. requestBody: description: Requested list of items to delete. required: true content: application/json: schema: $ref: '#/components/schemas/RequestTableUpdateByIdList' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /pending/rescan: post: description: Triggers a library scan. responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /pending/reorder: post: description: Reorder a list of pending tasks. requestBody: description: Requested list of items to reorder. required: true content: application/json: schema: $ref: '#/components/schemas/RequestPendingTasksReorder' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /pending/create: post: description: Create a new pending tasks from an absolute path requestBody: description: Specify path and library to create a pending tasks from. required: true content: application/json: schema: $ref: '#/components/schemas/RequestPendingTaskCreate' responses: '200': description: Successful request; Returns data for the generated task content: application/json: schema: $ref: '#/components/schemas/PendingTasksTableResults' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /pending/library/update: post: description: Set the library of a list of created tasks who's status has not yet been updated. requestBody: description: The ID list of the task to update and the Library Name to use. required: true content: application/json: schema: $ref: '#/components/schemas/RequestPendingTasksLibraryUpdate' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /pending/status/get: post: description: Set the status of a list of pending tasks requestBody: description: Set the status of a list of pending tasks. required: true content: application/json: schema: $ref: '#/components/schemas/RequestTableUpdateByIdList' responses: '200': description: 'Sample response: Returns a list of tasks with their status.' content: application/json: schema: $ref: '#/components/schemas/PendingTasksTableResults' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /pending/status/set/ready: post: description: Set the status of a list of created pending tasks as ready for processing requestBody: description: Set the status of a list of created pending tasks as ready for processing. required: true content: application/json: schema: $ref: '#/components/schemas/RequestTableUpdateByIdList' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /pending/download/file/id/{task_id}: get: description: Request a link for downloading a task file responses: '200': description: Successful request; Returns download link ID content: application/json: schema: $ref: '#/components/schemas/TaskDownloadLink' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /pending/download/data/id/{task_id}: get: description: Request a link for downloading a task data responses: '200': description: Successful request; Returns download link ID content: application/json: schema: $ref: '#/components/schemas/TaskDownloadLink' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/installed: post: description: Returns a list of installed plugins. requestBody: description: Requested a list of installed plugins. required: true content: application/json: schema: $ref: '#/components/schemas/RequestPluginsTableData' responses: '200': description: 'Sample response: Returns a list of installed plugins.' content: application/json: schema: $ref: '#/components/schemas/PluginsData' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/enable: post: description: DEPRECATED! Enable a list of plugins. requestBody: description: Requested list of plugins to enable. required: true content: application/json: schema: $ref: '#/components/schemas/RequestTableUpdateByIdList' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/disable: post: description: DEPRECATED! Disable a list of plugins. requestBody: description: Requested list of plugins to disable. required: true content: application/json: schema: $ref: '#/components/schemas/RequestTableUpdateByIdList' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/update: post: description: Update a list of plugins given their DB table IDs. requestBody: description: Requested list of plugins to update. required: true content: application/json: schema: $ref: '#/components/schemas/RequestTableUpdateByIdList' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/remove: delete: description: Remove a list of plugins given their DB table IDs. requestBody: description: Requested list of plugins to remove. required: true content: application/json: schema: $ref: '#/components/schemas/RequestTableUpdateByIdList' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/info: post: description: Returns a the metadata and settings of a requested plugin. requestBody: description: Requested a single plugin's info. required: true content: application/json: schema: $ref: '#/components/schemas/RequestPluginsInfo' responses: '200': description: 'Sample response: Returns a the metadata and settings of a requested plugin.' content: application/json: schema: $ref: '#/components/schemas/PluginsInfoResults' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/settings/update: post: description: Saves the settings of a single plugin. requestBody: description: Requested a plugins settings be updated. required: true content: application/json: schema: $ref: '#/components/schemas/RequestPluginsSettingsSave' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/settings/reset: post: description: Reset the settings of a single plugin. requestBody: description: Requested a plugins settings be reset. required: true content: application/json: schema: $ref: '#/components/schemas/RequestPluginsSettingsReset' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/installable: get: description: Returns a list of installable plugins. responses: '200': description: 'Sample response: Returns a list of installable plugins.' content: application/json: schema: $ref: '#/components/schemas/PluginsInstallableResults' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/install: post: description: Installs a plugin by its Plugin ID. requestBody: description: Requested a plugin be installed by its Plugin ID. required: true content: application/json: schema: $ref: '#/components/schemas/RequestPluginsById' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/flow: post: description: Returns the plugin flow for a requested plugin type. requestBody: description: Requests the plugin flow of a given plugin type. required: true content: application/json: schema: $ref: '#/components/schemas/RequestPluginsFlowByPluginType' responses: '200': description: 'Sample response: Returns the plugin flow for a requested plugin type.' content: application/json: schema: $ref: '#/components/schemas/PluginsInstallableResults' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/flow/types: get: description: Returns a list of all plugin types that have flows. responses: '200': description: 'Sample response: Returns a list of all plugin types that have flows.' content: application/json: schema: $ref: '#/components/schemas/PluginTypesResults' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/flow/save: post: description: Saves the plugin flow for a requested plugin type. requestBody: description: Requests saving the plugin flow for a given plugin type. required: true content: application/json: schema: $ref: '#/components/schemas/RequestSavingPluginsFlowByPluginType' responses: '200': description: 'Sample response: Save the plugin flow for a requested plugin type.' content: application/json: schema: $ref: '#/components/schemas/PluginsInstallableResults' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/repos/update: post: description: Updates the plugin repo list. requestBody: description: Requested an update to the plugin repo list. required: true content: application/json: schema: $ref: '#/components/schemas/RequestUpdatePluginReposList' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/repos/list: get: description: Returns a list of plugin repos. responses: '200': description: 'Sample response: Returns a list of plugin repos.' content: application/json: schema: $ref: '#/components/schemas/PluginReposListResults' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/repos/reload: post: description: Reload plugin repositories remote data. responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /plugins/panels/enabled: get: description: Returns a list of installed plugins. responses: '200': description: 'Success: Returns a list of installed plugins.' content: application/json: schema: $ref: '#/components/schemas/PluginsDataPanelTypesData' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /session/state: get: description: Returns the application session state. responses: '200': description: 'Sample response: Returns the application session state.' content: application/json: schema: $ref: '#/components/schemas/SessionStateSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /session/reload: post: description: Reload the current session. responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/read: get: description: Returns the application settings. responses: '200': description: 'Sample response: Returns the application settings.' content: application/json: schema: $ref: '#/components/schemas/SettingsReadAndWrite' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/write: post: description: Save a given dictionary of settings. requestBody: description: Requested a dictionary of settings to save. required: true content: application/json: schema: $ref: '#/components/schemas/SettingsReadAndWrite' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/configuration: get: description: Returns the system configuration. responses: '200': description: 'Sample response: Returns the system configuration.' content: application/json: schema: $ref: '#/components/schemas/SettingsSystemConfig' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/link/validate: post: description: Validate a remote installation address requestBody: description: The details of the remote installation to validate required: true content: application/json: schema: $ref: '#/components/schemas/RequestSettingsRemoteInstallationAddressValidation' responses: '200': description: 'Sample response: Returns the remote installation data.' content: application/json: schema: $ref: '#/components/schemas/SettingsRemoteInstallationData' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/worker_groups: get: description: Returns a list of all worker groups. responses: '200': description: 'Sample response: Returns a list of all worker groups.' content: application/json: schema: $ref: '#/components/schemas/WorkerGroupsList' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/worker_group/read: post: description: Read the configuration of a worker group requestBody: description: The ID of the worker group required: true content: application/json: schema: $ref: '#/components/schemas/RequestDatabaseItemById' responses: '200': description: 'Sample response: Returns the worker group configuration.' content: application/json: schema: $ref: '#/components/schemas/SettingsWorkerGroupConfig' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/worker_group/write: post: description: Write the configuration of a worker group requestBody: description: The config of a worker group that is to be saved required: true content: application/json: schema: $ref: '#/components/schemas/SettingsWorkerGroupConfig' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/worker_group/remove: delete: description: Remove a worker group requestBody: description: Requested a worker group to remove. required: true content: application/json: schema: $ref: '#/components/schemas/RequestDatabaseItemById' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/link/read: post: description: Read the configuration of a remote installation link requestBody: description: The UUID of the remote installation required: true content: application/json: schema: $ref: '#/components/schemas/RequestRemoteInstallationLinkConfig' responses: '200': description: 'Sample response: Returns the remote installation link configuration.' content: application/json: schema: $ref: '#/components/schemas/SettingsRemoteInstallationLinkConfig' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/link/write: post: description: Write the configuration of a remote installation link requestBody: description: The UUID of the remote installation and its configuration required: true content: application/json: schema: $ref: '#/components/schemas/SettingsRemoteInstallationLinkConfig' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/link/remove: delete: description: Remove a configuration for a remote installation link requestBody: description: Requested a remote installation link to remove. required: true content: application/json: schema: $ref: '#/components/schemas/RequestRemoteInstallationLinkConfig' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/libraries: get: description: Returns a list of all libraries. responses: '200': description: 'Sample response: Returns a list of all libraries.' content: application/json: schema: $ref: '#/components/schemas/SettingsLibrariesList' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/library/read: post: description: Read the configuration of one library requestBody: description: The ID of the library required: true content: application/json: schema: $ref: '#/components/schemas/RequestLibraryById' responses: '200': description: 'Sample response: Returns the remote installation link configuration.' content: application/json: schema: $ref: '#/components/schemas/SettingsLibraryConfigReadAndWrite' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/library/write: post: description: Write the configuration of one library requestBody: description: Requested a dictionary of settings to save. required: true content: application/json: schema: $ref: '#/components/schemas/SettingsLibraryConfigReadAndWrite' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/library/remove: delete: description: Remove a library requestBody: description: Requested a library to remove. required: true content: application/json: schema: $ref: '#/components/schemas/RequestLibraryById' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/library/export: post: description: Export the plugin configuration of one library requestBody: description: The ID of the library required: true content: application/json: schema: $ref: '#/components/schemas/RequestLibraryById' responses: '200': description: 'Sample response: Returns the remote installation link configuration.' content: application/json: schema: $ref: '#/components/schemas/SettingsLibraryPluginConfigExport' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /settings/library/import: post: description: Import the configuration of one library requestBody: description: Requested a dictionary of settings to save. required: true content: application/json: schema: $ref: '#/components/schemas/SettingsLibraryPluginConfigImport' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /upload/pending/file: post: description: Uploads a file to the pending tasks list requestBody: description: Uploads a file to the pending tasks list required: true content: multipart/form-data: schema: type: object properties: fileName: type: string format: binary responses: '200': description: Successful request; Returns data for the generated task content: application/json: schema: $ref: '#/components/schemas/PendingTasksTableResults' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /upload/plugin/file: post: description: Uploads a plugin ZIP file and installs it requestBody: description: Uploads a plugin ZIP file and installs it required: true content: multipart/form-data: schema: type: object properties: fileName: type: string format: binary responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /version/read: get: description: Returns the application version. responses: '200': description: 'Sample response: Returns the application version.' content: application/json: schema: $ref: '#/components/schemas/VersionReadSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /workers/worker/pause: post: description: Pauses a worker by its ID. requestBody: description: Requested a worker be paused by its ID. required: true content: application/json: schema: $ref: '#/components/schemas/RequestWorkerById' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /workers/worker/pause/all: post: description: Pause all workers. responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /workers/worker/resume: post: description: Resumes a worker by its ID. requestBody: description: Requested a worker be resumed by its ID. required: true content: application/json: schema: $ref: '#/components/schemas/RequestWorkerById' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /workers/worker/resume/all: post: description: Resumes all workers. responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /workers/worker/terminate: delete: description: Terminates a worker by its ID. requestBody: description: Requested a worker be terminated by its ID. required: true content: application/json: schema: $ref: '#/components/schemas/RequestWorkerById' responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /workers/worker/terminate/all: delete: description: Terminate all workers. responses: '200': description: Successful request; Returns success status content: application/json: schema: $ref: '#/components/schemas/BaseSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' /workers/status: get: description: Returns the status of all workers. responses: '200': description: 'Sample response: Returns the status of all workers.' content: application/json: schema: $ref: '#/components/schemas/WorkerStatusSuccess' '400': description: Bad request; Check `messages` for any validation errors content: application/json: schema: $ref: '#/components/schemas/BadRequest' '404': description: Bad request; Requested endpoint not found content: application/json: schema: $ref: '#/components/schemas/BadEndpoint' '405': description: Bad request; Requested method is not allowed content: application/json: schema: $ref: '#/components/schemas/BadMethod' '500': description: Internal error; Check `error` for exception content: application/json: schema: $ref: '#/components/schemas/InternalError' openapi: 3.0.0