API referenceScheduled maintenances
List scheduled maintenances
Lists the project's scheduled maintenance windows, newest window first, cursor-paginated.
Authorization
bearerAuth AuthorizationBearer <token>
An uptimely_live_ project API key (Settings → API Keys).
In: header
Query Parameters
limit?integer
Maximum number of items to return (1-100).
Range
1 <= value <= 100Default
25after?string
Opaque cursor from a previous page's next_cursor — omit for the first page. Reusing a cursor with DIFFERENT query parameters (e.g. a different limit) answers 400 validation_failed.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/scheduled-maintenances"{ "data": [ { "id": "string", "title": "string", "description": "string", "state": { "name": "string", "color": "string" }, "starts_at": "2019-08-24T14:15:22Z", "ends_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z" } ], "has_more": true, "next_cursor": "string"}