Internal UI API¶

The running application exposes its complete FastAPI schema at:

• GET /docs
• GET /redoc
• GET /openapi.json

These generated documents include internal UI routes as well as the mounted external API. Contributors can use them for the exact internal request and response models.

Status And Setup¶

• GET /api/setup/status
• POST /api/setup
• GET /health
• GET /version
• GET /update-status

Dashboard And UI State¶

• GET /api/dashboard
• GET /api/info/sidebar-indicators
• GET /api/info/ui-indicators
• GET /api/alerts
• GET /api/notices

Settings¶

• GET /api/settings/general
• PUT /api/settings/general
• GET /api/settings/services
• POST /api/settings/save/service
• DELETE /api/settings/service/{service_config_id}
• POST /api/settings/notifications/test
• GET /api/settings/oidc
• GET /api/settings/integrations/api-tokens
• GET /api/settings/integrations/webhooks
• GET /api/settings/integrations/webhook-deliveries

Tasks¶

• GET /api/tasks/tasks
• GET /api/tasks/tasks/{task_id}
• POST /api/tasks/tasks/{task_id}/run
• PUT /api/tasks/tasks/{task_id}/schedule
• GET /api/tasks/history

Media And Reclaim Flow¶

• GET /api/media/candidates
• GET /api/media/candidates/presence
• POST /api/media/candidates/delete
• POST /api/media/candidates/move
• GET /api/media/reclaim-history

Requests And Protection¶

• GET /api/protection-requests
• POST /api/protection-requests
• GET /api/delete-requests
• POST /api/delete-requests
• GET /api/protected
• POST /api/protected
• PUT /api/protected/{entry_id}/duration
• DELETE /api/protected/{entry_id}

Rules¶

• GET /api/rules
• POST /api/rules
• POST /api/rules/{rule_id}
• DELETE /api/rules/{rule_id}
• POST /api/rules/import
• POST /api/rules/preview
• POST /api/rules/validate-regex
• POST /api/rules/validate-paths
• GET /api/rules/path-tree
• GET /api/rules/seerr-users
• GET /api/rules/movie-collections
• GET /api/rules/genres
• GET /api/rules/original-languages
• GET /api/rules/origin-countries
• GET /api/rules/media-server-collections
• GET /api/rules/check-synced

The lookup endpoints are admin-only helpers used by the rule editor. Language results use canonical ISO 639-3 codes. Country results use the codes currently stored in local TMDB metadata. Both endpoints support media-type filtering, search, and pagination.

Rule actions support outcome: "candidate" and outcome: "protect". Existing rules without an outcome remain candidate rules for compatibility. Protection previews include items that are already protected because the preview reports what the rule itself matches.

Protected-entry responses include source, source_rule_id, and source_rule_name. Entries with source: "rule" are managed by cleanup scans; duration updates and direct deletion return 409 Conflict.

Internal Behavior Notes¶

• Most routes require the frontend's session-cookie authentication.
• Some routes are admin-only, especially settings and task management.
• Saving an existing service with enabled: false does not require the external service to be reachable. Enabling it still performs connection validation.
• Deleting the active main media server returns a conflict until another main server is assigned.
• Task execution and file operations are queued when appropriate, so internal routes often return a queued-job response instead of completing work inline.