POST /maintenances

Request body

{
  "title": "string",
  "scheduled_start_at": "2026-01-01T00:00:00.000Z",
  "scheduled_end_at": "2026-01-01T00:00:00.000Z",
  "affected_services": [
    "string"
  ],
  "visible_to_customer_ids": [
    "string"
  ]
}

Example request

curl -X POST "/api/v1/maintenances" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"string\",\"scheduled_start_at\":\"2026-01-01T00:00:00.000Z\",\"scheduled_end_at\":\"2026-01-01T00:00:00.000Z\",\"affected_services\":[\"string\"],\"visible_to_customer_ids\":[\"string\"]}"

Responses

200: ok

{
  "id": "string",
  "title": "string",
  "type": "Incident",
  "severity": null,
  "state": "draft",
  "published_at": null,
  "resolved_at": null,
  "scheduled_start_at": null,
  "scheduled_end_at": null,
  "actual_start_at": null,
  "actual_end_at": null,
  "canceled_at": null,
  "postmortem_url": null,
  "affected_services": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "visible_to_customer_ids": [
    "string"
  ],
  "messages": [
    {
      "id": "string",
      "type": "Investigating",
      "description": "string",
      "date": "2026-01-01T00:00:00.000Z"
    }
  ],
  "created_at": "2026-01-01T00:00:00.000Z"
}

401: missing or invalid bearer token

403: missing required scope

404: not found (or cross-tenant: same response)

429: rate limit exceeded