---
title: "Create monitoring instance"
method: POST
path: "/namespaces/{namespace}/monitoring-instances"
tags: ["Monitoring"]
---

# Create monitoring instance

`POST /namespaces/{namespace}/monitoring-instances`

This API creates a new monitoring instance.

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.

## Path parameters

- `namespace` string, required

## Request body

- MonitoringInstanceCreateParams — Monitoring instance information
  - `type` 'pmm', required
  - `url` string, required
  - `allowedNamespaces` string[] — 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
  - `namespace` string
  - `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
  - `namespace` string

## Other responses

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

---

[API](https://skmtc.net/openeverest/apis/openeverest-schema.md) · [All operations](https://skmtc.net/openeverest/apis/openeverest-schema/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openeverest/openeverest-schema/versions/46b19e13670b/schema)