Services

Get services.

get

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Query parameters

start-indexinteger · int32Optional

an integer specifying the starting point (beginning with 0) when paging through a list of entities

Default: 0

max-resultsinteger · int32 · max: 100Optional

the maximum number of results when paging through a list of services. (Note: when using ?include maximum is reduced to 25)

Default: 10

Responses

200

The services

application/json

get

/services

HTTPcURLJavaScriptPython

GET /api/services HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

The services

[
  {
    "id": 1,
    "name": "text",
    "status": "OPERATIONAL",
    "description": "text",
    "oneOpenIncidentOnly": true,
    "showUptimeHistory": true,
    "teams": [
      {
        "id": 1,
        "name": "text"
      }
    ],
    "subscribed": true,
    "uptime": {
      "rangeStart": "2025-12-27T20:29:24.984Z",
      "rangeEnd": "2025-12-27T20:29:24.984Z",
      "outages": [
        {
          "status": "OPERATIONAL",
          "from": "2025-12-27T20:29:24.984Z",
          "until": "2025-12-27T20:29:24.984Z"
        }
      ],
      "uptimePercentage": {
        "uptimePercentage": {
          "p90": 1,
          "p60": 1,
          "p30": 1
        }
      }
    },
    "incidents": [
      {
        "id": 1,
        "summary": "text",
        "status": "INVESTIGATING",
        "message": "text",
        "sendNotification": true,
        "createdAt": "2025-12-27T20:29:24.984Z",
        "updatedAt": "2025-12-27T20:29:24.984Z",
        "affectedServices": [
          {
            "impact": "OPERATIONAL",
            "service": {
              "id": 1,
              "name": "text",
              "status": "OPERATIONAL",
              "description": "text",
              "oneOpenIncidentOnly": true,
              "showUptimeHistory": true,
              "teams": [
                {
                  "id": 1,
                  "name": "text"
                }
              ]
            }
          }
        ],
        "resolvedOn": "2025-12-27T20:29:24.984Z"
      }
    ]
  }
]

Create a new service.

post

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Body

application/json

idnumberOptional

namestringOptional

statusstring · enumOptional

the service status

Possible values:

descriptionstringOptional

oneOpenIncidentOnlybooleanOptional

showUptimeHistorybooleanOptional

Responses

200

The newly created service

application/json

post

/services

HTTPcURLJavaScriptPython

POST /api/services HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 151

{
  "id": 1,
  "name": "text",
  "status": "OPERATIONAL",
  "description": "text",
  "oneOpenIncidentOnly": true,
  "showUptimeHistory": true,
  "teams": [
    {
      "id": 1,
      "name": "text"
    }
  ]
}

200

The newly created service

{
  "id": 1,
  "name": "text",
  "status": "OPERATIONAL",
  "description": "text",
  "oneOpenIncidentOnly": true,
  "showUptimeHistory": true,
  "teams": [
    {
      "id": 1,
      "name": "text"
    }
  ]
}

Get a specific service.

get

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Query parameters

Responses

200

The requested service

application/json

get

/services/{id}

HTTPcURLJavaScriptPython

GET /api/services/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

The requested service

{
  "id": 1,
  "name": "text",
  "status": "OPERATIONAL",
  "description": "text",
  "oneOpenIncidentOnly": true,
  "showUptimeHistory": true,
  "teams": [
    {
      "id": 1,
      "name": "text"
    }
  ],
  "subscribed": true,
  "uptime": {
    "rangeStart": "2025-12-27T20:29:24.984Z",
    "rangeEnd": "2025-12-27T20:29:24.984Z",
    "outages": [
      {
        "status": "OPERATIONAL",
        "from": "2025-12-27T20:29:24.984Z",
        "until": "2025-12-27T20:29:24.984Z"
      }
    ],
    "uptimePercentage": {
      "uptimePercentage": {
        "p90": 1,
        "p60": 1,
        "p30": 1
      }
    }
  },
  "incidents": [
    {
      "id": 1,
      "summary": "text",
      "status": "INVESTIGATING",
      "message": "text",
      "sendNotification": true,
      "createdAt": "2025-12-27T20:29:24.984Z",
      "updatedAt": "2025-12-27T20:29:24.984Z",
      "affectedServices": [
        {
          "impact": "OPERATIONAL",
          "service": {
            "id": 1,
            "name": "text",
            "status": "OPERATIONAL",
            "description": "text",
            "oneOpenIncidentOnly": true,
            "showUptimeHistory": true,
            "teams": [
              {
                "id": 1,
                "name": "text"
              }
            ]
          }
        }
      ],
      "resolvedOn": "2025-12-27T20:29:24.984Z"
    }
  ]
}

Update the specific service

put

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Body

application/json

idnumberOptional

namestringOptional

statusstring · enumOptional

the service status

Possible values:

descriptionstringOptional

oneOpenIncidentOnlybooleanOptional

showUptimeHistorybooleanOptional

Responses

200

The updated service

application/json

put

/services/{id}

HTTPcURLJavaScriptPython

PUT /api/services/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 151

{
  "id": 1,
  "name": "text",
  "status": "OPERATIONAL",
  "description": "text",
  "oneOpenIncidentOnly": true,
  "showUptimeHistory": true,
  "teams": [
    {
      "id": 1,
      "name": "text"
    }
  ]
}

200

The updated service

{
  "id": 1,
  "name": "text",
  "status": "OPERATIONAL",
  "description": "text",
  "oneOpenIncidentOnly": true,
  "showUptimeHistory": true,
  "teams": [
    {
      "id": 1,
      "name": "text"
    }
  ]
}

Remove a specific service.

delete

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Responses

204

Empty body delete response

delete

/services/{id}

HTTPcURLJavaScriptPython

DELETE /api/services/{id} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

204

Empty body delete response

No content

Get the subscribers (users and teams) of a service

get

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Responses

200

The subscribers of the service

application/json

get

/services/{id}/private-subscribers

HTTPcURLJavaScriptPython

GET /api/services/{id}/private-subscribers HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

The subscribers of the service

[
  {
    "id": 1,
    "name": "text",
    "type": "USER"
  }
]

Set subscribers (users and teams) of a service

put

Note: this is an in place update

Authorizations

apiKey

AuthorizationstringRequired

The Bearer API key of your user more info.

Path parameters

idnumberRequired

entity ID

Bodyobject[]

application/json

idnumberOptional

namestringOptional

typestring · enumOptionalPossible values:

Responses

204

the response

put

/services/{id}/private-subscribers

HTTPcURLJavaScriptPython

PUT /api/services/{id}/private-subscribers HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 38

[
  {
    "id": 1,
    "name": "text",
    "type": "USER"
  }
]

204

the response

No content