Alerting profiles API - DELETE a profile

Deletes the specified alerting profile. Deletion can't be undone. The Default alerting profile can't be deleted.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

  • Managed https://{your-domain}/e/{your-environment-id}/api/config/v1/alertingProfiles/{id}
  • SaaS https://{your-environment-id}{id}
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/alertingProfiles/{id}


To execute this request, you need the Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.


Parameter Type Description In Required
id string

The ID of the alerting profile to be deleted.

path required


Response codes

Code Description

Success. The alerting profile has been deleted. Response doesn't have a body.

Response body

A successful request doesn't return any content.


In this example, the request deletes the alerting profile from the POST request example. The response code of 204 indicates that the deletion was successful.

The API token is passed in the Authorization header.


curl -X DELETE \ \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

Response code