---
title: "POST /public/monitoring/v2/cluster/{cluster}/alert"
method: POST
path: "/public/monitoring/v2/cluster/{cluster}/alert"
tags: ["cli_alert_monitoring_v2_21"]
deprecated: true
---

# POST /public/monitoring/v2/cluster/{cluster}/alert

`POST /public/monitoring/v2/cluster/{cluster}/alert`

## Request

- Base URL: `https://developers.conduktor.io` (the document declares no server; this is the origin it was published from)
- URL: `https://developers.conduktor.io/public/monitoring/v2/cluster/{cluster}/alert`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/conduktor/apis/conduktor-console-api/docs/public/monitoring/v2/cluster/:cluster/alert/post.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Create a Alert

**Requires a paid license.** Returns 403 Forbidden on Free plan.

## Path parameters

- `cluster` string, required

## Request body

- AlertResourceV2
  - `apiVersion` string, required
  - `kind` 'Alert', required
  - `metadata` AlertMetadata, required
    - `name` string, required
    - `cluster` string, required
  - `spec` union, required
    - BrokerAlertV2
      - `threshold` integer, required
      - `operator` 'GreaterThan' | 'GreaterThanOrEqual' | 'LessThan' | 'LessThanOrEqual' | 'NotEqual', required
      - `metric` 'MessageIn' | 'MessageOut' | 'MessageSize' | 'OfflinePartitionCount' | 'PartitionCount' | 'UnderMinIsrPartitionCount' | 'UnderReplicatedPartitionCount', required
      - `description` string
      - `displayName` string
      - `disable` boolean
      - `type` 'BrokerAlert', required
    - ConsumerGroupAlertV2
      - `consumerGroupName` string, required
      - `threshold` integer, required
      - `operator` 'GreaterThan' | 'GreaterThanOrEqual' | 'LessThan' | 'LessThanOrEqual' | 'NotEqual', required
      - `metric` 'OffsetLag' | 'TimeLag', required
      - `description` string
      - `displayName` string
      - `disable` boolean
      - `topicName` string
      - `type` 'ConsumerGroupAlert', required
    - KafkaConnectAlertV2
      - `connectName` string, required
      - `connectorName` string, required
      - `threshold` integer, required
      - `operator` 'GreaterThan' | 'GreaterThanOrEqual' | 'LessThan' | 'LessThanOrEqual' | 'NotEqual', required
      - `metric` 'FailedTaskCount', required
      - `description` string
      - `displayName` string
      - `disable` boolean
      - `type` 'KafkaConnectAlert', required
    - TopicAlertV2
      - `topicName` string, required
      - `threshold` integer, required
      - `operator` 'GreaterThan' | 'GreaterThanOrEqual' | 'LessThan' | 'LessThanOrEqual' | 'NotEqual', required
      - `metric` 'MessageCount' | 'MessageIn' | 'MessageOut' | 'MessageSize', required
      - `description` string
      - `displayName` string
      - `disable` boolean
      - `type` 'TopicAlert', required

## Response `200`

- AlertCreateResultV2
  - `resource` AlertResourceV2, required
    - `apiVersion` string, required
    - `kind` 'Alert', required
    - `metadata` AlertMetadata, required
      - `name` string, required
      - `cluster` string, required
    - `spec` union, required
      - BrokerAlertV2
        - `threshold` integer, required
        - `operator` 'GreaterThan' | 'GreaterThanOrEqual' | 'LessThan' | 'LessThanOrEqual' | 'NotEqual', required
        - `metric` 'MessageIn' | 'MessageOut' | 'MessageSize' | 'OfflinePartitionCount' | 'PartitionCount' | 'UnderMinIsrPartitionCount' | 'UnderReplicatedPartitionCount', required
        - `description` string
        - `displayName` string
        - `disable` boolean
        - `type` 'BrokerAlert', required
      - ConsumerGroupAlertV2
        - `consumerGroupName` string, required
        - `threshold` integer, required
        - `operator` 'GreaterThan' | 'GreaterThanOrEqual' | 'LessThan' | 'LessThanOrEqual' | 'NotEqual', required
        - `metric` 'OffsetLag' | 'TimeLag', required
        - `description` string
        - `displayName` string
        - `disable` boolean
        - `topicName` string
        - `type` 'ConsumerGroupAlert', required
      - KafkaConnectAlertV2
        - `connectName` string, required
        - `connectorName` string, required
        - `threshold` integer, required
        - `operator` 'GreaterThan' | 'GreaterThanOrEqual' | 'LessThan' | 'LessThanOrEqual' | 'NotEqual', required
        - `metric` 'FailedTaskCount', required
        - `description` string
        - `displayName` string
        - `disable` boolean
        - `type` 'KafkaConnectAlert', required
      - TopicAlertV2
        - `topicName` string, required
        - `threshold` integer, required
        - `operator` 'GreaterThan' | 'GreaterThanOrEqual' | 'LessThan' | 'LessThanOrEqual' | 'NotEqual', required
        - `metric` 'MessageCount' | 'MessageIn' | 'MessageOut' | 'MessageSize', required
        - `description` string
        - `displayName` string
        - `disable` boolean
        - `type` 'TopicAlert', required
  - `createResult` 'AlreadyExist' | 'Created', required

## Other responses

- `400`: The request is not valid
- `401`: The user is not authenticated
- `403`: The user doesn't have sufficient privilege to do this operation
- `404`: No alert with this technical id exists
- `409`: Resource already exists
- `500`: An unexpected error occurred in the server

---

[API](https://skmtc.dev/conduktor/apis/conduktor-console-api.md) - [All operations](https://skmtc.dev/conduktor/apis/conduktor-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conduktor/apis/conduktor-console-api/revisions/24750c294805?raw)