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: https://my-company.my-alerting-solution.com/my-service.

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.

Example

curl --request POST \
     --url https://{host}.leanix.net/services/vsm-collector/v1/item \
     --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": "https://my-company.my-alerting-solution.com/my-service"
     }
}
'

Did this page help you?