---
title: "Create a new monitoring instance object"
method: POST
path: "/monitoring-instances"
tags: ["monitoringInstances"]
---

# Create a new monitoring instance object

`POST /monitoring-instances`

A monitoring instance object requires `type` to be set.
Based on the `type` the respective key with configuration needs to be set.
Such as, if `type: pmm`, then `pmm` key needs to be provided with a configuration.

## Request body

- MonitoringInstanceCreateParams — Monitoring instance information
  - `type` 'pmm', required
  - `url` string, required
  - `allowedNamespaces` string[], required — List of namespaces allowed to use this monitoring instance
  - `verifyTLS` boolean — VerifyTLS is set to ensure TLS/SSL verification.
  - `name` string, required — A user defined string name of the storage in the DNS name format https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-label-names
  - `pmm` object
    - `user` string
    - `password` string
    - `apiKey` string

## Response `200`

Successful operation

- MonitoringInstance — Monitoring instance information
  - `type` 'pmm'
  - `url` string
  - `allowedNamespaces` string[] — List of namespaces allowed to use this monitoring instance
  - `verifyTLS` boolean — VerifyTLS is set to ensure TLS/SSL verification.
  - `name` string — A user defined string name of the storage in the DNS name format https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-label-names

## Other responses

- `400` — Unsuccessful operation
- `500` — Internal server error

## Changes

- **2024-04-12** `dec31e5eea8e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openeverest/apis/openeverest-schema/changes/monitoring-instances/post.md)

---

[API](https://skmtc.dev/openeverest/apis/openeverest-schema.md) · [All operations](https://skmtc.dev/openeverest/apis/openeverest-schema/llms.txt) · [OpenAPI document](https://skmtc.dev/openeverest/apis/openeverest-schema/revisions/dec31e5eea8e?raw)