Check whether the configured YTPTube API is reachable.

Read YTPTube system configuration. Sensitive fields are recursively redacted.

Read the active yt-dlp option configuration.

Parse and validate yt-dlp CLI options without starting a download.

Inspect URL metadata without adding it to the download queue.

Read recent YTPTube application logs (when file logging is enabled).

Read current in-memory queue progress and counts.

List a paginated queue or completed-history page.

Read one queue or history item by ID.

Add one or more URLs to the download queue.

Read a history item and requeue only saved download-request fields.

Start, pause, force-start, reorder, or cancel queued downloads.

Delete queue/history records selected by IDs or a status filter; media deletion is opt-in.

List archive entries for a preset, optionally filtered by archive IDs.

Archive or unarchive a history item using its configured archive file.

Generate task metadata, NFO, and image sidecar files.

Generate an NFO sidecar for a completed history item.

List scheduled tasks with pagination.

Read a scheduled task by numeric ID.

Preview the task handler and items for a URL; this only calls /api/tasks/inspect and never queues downloads.

Create one or more scheduled tasks.

Partially update a scheduled task.

Replace a scheduled task using the API PUT contract.

List download presets with pagination and sorting.

Read a download preset by numeric ID.

Create a download preset.

Partially update a non-default download preset.

Replace a non-default download preset using the API PUT contract.