Import Services via Custom Integrations


API Documentation

Please find the extensive API documentation here.

The /item endpoint allows you to bring in your services from your source systems that might not (yet) be supported by out-of-the-box integrations.

To bring in services the type parameter in the POST call to the /item endpoint needs to be set to SERVICE.
The data object can carry any key-value pairs that you may want to bring to VSM. Examples could be number of incidents: 2 or monitoring_dashboard:

The visualization of the data object in the VSM UI will come shortly.

Accordingly, the request body will have to follow the below schema:
type : SERVICE
data: no schema restrictions - you can bring in your own key-value pairs. See the example below.

Find more information on how to get the Bearer Token here.


curl --request POST \
     --url https://{host} \
     --header 'Accept: */*' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer <TOKEN>' \
     --data '
     "id": "svc12345",
     "sourceType": "my-alerting-solution",
     "sourceInstance": "my-company",
     "name": "my-service",
     "type": "SERVICE",
     "description": "The one and only service with 110% uptime",
     "data": {
          "number_of_incidents": "2",
          "monitoring_dashboard": ""

Did this page help you?