Files
profilarr/docs/api/v1/paths/system.yaml
2026-04-09 05:47:20 +09:30

110 lines
3.3 KiB
YAML

health:
get:
operationId: getHealth
summary: Health Check
description: |
Public endpoint, no authentication required. Use this for uptime monitors
and load balancers. Returns 200 for healthy or degraded, 503 for unhealthy.
tags:
- System
security: []
responses:
'200':
description: System is healthy or degraded (status field indicates which)
content:
application/json:
schema:
$ref: '../schemas/health.yaml#/HealthCheckResponse'
example:
status: healthy
timestamp: '2026-03-09T12:00:00.000Z'
'503':
description: System is unhealthy (status field will be "unhealthy")
content:
application/json:
schema:
$ref: '../schemas/health.yaml#/HealthCheckResponse'
example:
status: unhealthy
timestamp: '2026-03-09T12:00:00.000Z'
status:
get:
operationId: getStatus
summary: System Status
description: |
Single-call overview designed for dashboard integrations (e.g. Homepage).
The `drift` field on each arr is reserved for future use and always null.
tags:
- System
responses:
'200':
description: System status
content:
application/json:
schema:
$ref: '../schemas/status.yaml#/StatusResponse'
example:
version: '2.0.0'
uptime: 86400
databases:
- id: 1
name: Dictionarry
enabled: true
lastSyncedAt: '2026-04-09T12:00:00Z'
syncStrategy: auto
counts:
customFormats: 52
qualityProfiles: 3
regularExpressions: 120
delayProfiles: 1
arrs:
- id: 1
name: Radarr
type: radarr
enabled: true
sync:
qualityProfiles:
count: 2
status: idle
lastSyncedAt: '2026-04-09T12:00:00Z'
delayProfiles:
configured: true
status: idle
lastSyncedAt: '2026-04-09T12:00:00Z'
mediaManagement:
configured: true
status: idle
lastSyncedAt: '2026-04-09T12:00:00Z'
drift: null
jobs:
active: 0
queued: 2
nextRunAt: '2026-04-09T13:00:00Z'
backups:
enabled: true
lastBackupAt: '2026-04-09T00:00:00Z'
'401':
description: Not authenticated
content:
application/json:
schema:
$ref: '../schemas/common.yaml#/ErrorResponse'
openapi:
get:
operationId: getOpenApiSpec
summary: OpenAPI Specification
description: |
Returns the resolved OpenAPI 3.1 spec as a single JSON document.
Useful for generating client SDKs or feeding to documentation tools.
tags:
- System
responses:
'200':
description: OpenAPI specification
content:
application/json:
schema:
type: object