---
title: "POST /types"
method: POST
path: "/types"
---

# POST /types

`POST /types`

## Request

- Base URL: `https://dev-cloud.acronis.com/api/alert_manager/v1`
- URL: `https://dev-cloud.acronis.com/api/alert_manager/v1/types`
- Auth: OAuth 2
  - Authorization code: `https://dev-cloud.acronis.com/api/2/idp/authorize`
  - Client credentials
  - Password
  - Token URL: `https://dev-cloud.acronis.com/api/2/idp/token` scopes: `urn:acronis.com::alert_manager::admin`

Registers a new alert type.

## Request body

- object: A list of types to register.
  - `items` Type[], required
    - `id` string, required
    - `enabled` boolean, required: Alerts of disabled types are treated as non-existent for any GET request until type is enabled again.
    - `severity` 'ok' | 'information' | 'warning' | 'error' | 'critical', required: Alert severity level.
    - `contextKeys` string[], required: **Deprecated.** A list of context keys that are used for validation of completeness and correctness of alert context object.
    - `searchableDetails` string[], required: A list of keys by which the alert type could be found and filtered.
    - `exportable` ACEPKeyValue[]: Mapping between `contextKeys` and `acep` field names to allow exporting of the required fields to ACEP.
      - `name` string, required: Context field key name.
      - `acep_name` string, required: Alias for corresponding field in ACEP.
      - `acep_path` string: If a custom column is JSON data, this property makes possible to export specific field from JSON.
    - `supportedOS` OSType[], required: A list of operating systems that are supported by the alert type.
    - `notificationType` string: If specified, a notification of the specified type will be triggered on alert creation.
    - `notificationExtraRecipients` NotificationRecipient[]: A list of additional notification targets that will receive notifications for alerts of this type. By default notification is sent to the alert's tenant and its children.
    - `category` string, required: Alert type category.
    - `cti_name` string: A cti-name used as an event subject type while sending events to event manager.
    - `alias` string: Alert type name alias.

## Response `204`

Alert types were successfully registered.

## Other responses

- `400`: Input parameters error.
- `401`: Request is refused because authentication parameters are invalid.
- `403`: A security error due to an issue with tenant security claim: invalid tenant in the access token, tenant resolution failed and etc.

---

[API](https://skmtc.dev/acronis/apis/alert-manager-api.md) - [All operations](https://skmtc.dev/acronis/apis/alert-manager-api/llms.txt) - [OpenAPI document](https://skmtc.dev/acronis/apis/alert-manager-api/revisions/540eec169663?raw)