# Maintenance Windows - X-Radius API > Base URL: https://x-radius.com/api/v1 > Auth: Authorization: Bearer xrt_... (a manager API token) > Envelope: {"data": ...}; lists add {"meta":{page,page_size,total,has_next}} > Errors: {"error":{"code","message","request_id"}} - branch on code, never on message > Timestamps: yyyy-MM-dd HH:mm:ss, UTC > Money: a bare JSON number in major units, with an ISO-4217 currency code beside it > Idempotency: redeem and activate endpoints take a client-supplied request_id (UUID) > > This page: https://x-radius.com/docs/api/maintenance-windows > Every group: https://x-radius.com/llms.txt 8 endpoints in 1 resource groups. 0 carry a hand-written reference entry with examples; the remaining 8 are generated from the running router and carry method, path, authentication, permission and rate-limit bucket, but no request or response example. ### View maintenance windows `GET /api/v1/maintenance-windows` - Authentication: manager session (JWT) or API token - Permission: `prm_maintenance_view` (View maintenance windows) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Schedule and manage maintenance windows `POST /api/v1/maintenance-windows` - Authentication: manager session (JWT) or API token - Permission: `prm_maintenance_manage` (Schedule and manage maintenance windows) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Schedule and manage maintenance windows `DELETE /api/v1/maintenance-windows/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_maintenance_manage` (Schedule and manage maintenance windows) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### View maintenance windows `GET /api/v1/maintenance-windows/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_maintenance_view` (View maintenance windows) - Risk: read _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Schedule and manage maintenance windows `PATCH /api/v1/maintenance-windows/{id}` - Authentication: manager session (JWT) or API token - Permission: `prm_maintenance_manage` (Schedule and manage maintenance windows) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Schedule and manage maintenance windows `POST /api/v1/maintenance-windows/{id}/cancel` - Authentication: manager session (JWT) or API token - Permission: `prm_maintenance_manage` (Schedule and manage maintenance windows) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Schedule and manage maintenance windows `POST /api/v1/maintenance-windows/{id}/complete` - Authentication: manager session (JWT) or API token - Permission: `prm_maintenance_manage` (Schedule and manage maintenance windows) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._ ### Schedule and manage maintenance windows `POST /api/v1/maintenance-windows/{id}/start` - Authentication: manager session (JWT) or API token - Permission: `prm_maintenance_manage` (Schedule and manage maintenance windows) - Risk: write - Rate limit bucket: `t_mutate` _This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._