Delete an alert rule

DELETE

/v:version/alert-rules/:resourceId

DELETE

/v:version/alert-rules/:resourceId

1 curl -X DELETE https://test.api.solvimon.com/v1/alert-rules/ \
2      -H "X-API-KEY: <apiKey>" \
3      -H "Content-Type: application/json" \
4      -d '{}'

1 {
2   "reference": "AR-20240601-001",
3   "object_type": "alert_rule",
4   "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
5   "name": "High CPU Usage Alert",
6   "description": "Triggers when CPU usage exceeds 90% for more than 5 minutes",
7   "status": "DRAFT",
8   "customer_ids": [
9     "cust-987654321"
10   ],
11   "customers": [
12     {
13       "reference": "CUST-001",
14       "type": "ORGANIZATION",
15       "email": "contact@acmecorp.com",
16       "roles": [
17         "DEFAULT"
18       ],
19       "object_type": "customer",
20       "id": "cust-987654321",
21       "created_at": "2023-11-15T09:30:00Z",
22       "parent_customer_id": "org-123456789",
23       "parent_customer_ids": [
24         "org-123456789"
25       ],
26       "status": "ACTIVE",
27       "timezone": "America/New_York",
28       "notification_preferences": [
29         {
30           "type": "INVOICE",
31           "channels": [
32             {
33               "type": "EMAIL",
34               "enabled": true
35             }
36           ]
37         }
38       ],
39       "locale": "en-US",
40       "individual": {
41         "name": {
42           "first_name": "John",
43           "last_name": "Doe",
44           "infix": ""
45         },
46         "residential_address": {
47           "line1": "123 Maple Street",
48           "line2": "Suite 400",
49           "city": "Springfield",
50           "postal_code": "01103",
51           "state": "MA",
52           "country": "US"
53         }
54       },
55       "organization": {
56         "legal_name": "Acme Corporation",
57         "tax_id": "98-7654321",
58         "tax_ids": [
59           {
60             "id": "98-7654321",
61             "type": "EIN"
62           }
63         ],
64         "registration_number": "REG-2023-4567",
65         "tax_exempt": false,
66         "tax_exempt_note": "",
67         "registered_address": {
68           "line1": "456 Industrial Way",
69           "line2": "",
70           "city": "Springfield",
71           "postal_code": "01104",
72           "state": "MA",
73           "country": "US"
74         }
75       },
76       "custom_fields": [
77         {
78           "id": "cf-001",
79           "reference": "preferred_contact_method",
80           "value": "email",
81           "values": [
82             "email",
83             "phone"
84           ],
85           "integration_details": {
86             "payment_gateway_variant": "STRIPE",
87             "id": "int-123",
88             "reference": "stripe_integration",
89             "adyen": {
90               "recurring_detail_reference": ""
91             },
92             "stripe": {
93               "payment_method_id": "pm_1GqIC8Lz0qyl6XeW3xYz1234"
94             }
95           }
96         }
97       ],
98       "processing_only": false,
99       "pricing_plan_subscription_selector": {
100         "data": [
101           {
102             "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
103             "value": "US"
104           }
105         ],
106         "rules": [
107           {
108             "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
109             "type": "EQUALS"
110           }
111         ],
112         "filters": [
113           {
114             "field": "BILLING_ENTITY_REGISTERED_ADDRESS_COUNTRY",
115             "type": "EQUALS",
116             "value": "US"
117           }
118         ],
119         "fallback": "LATEST"
120       },
121       "linked_integrations": [
122         {
123           "id": "int-123",
124           "link_details": [
125             {
126               "url": "https://dashboard.stripe.com/customers/cust_987654321",
127               "custom_field_name": "Stripe Customer Link"
128             }
129           ]
130         }
131       ]
132     }
133   ],
134   "type": "ENTITLEMENT",
135   "trigger_type": "STATIC",
136   "entitlement": {
137     "feature_id": "feat-001",
138     "comparator": "EQUALS",
139     "feature": {
140       "reference": "CPU_USAGE_SWITCH",
141       "object_type": "feature",
142       "id": "feat-001",
143       "name": "CPU Usage Switch",
144       "description": "Feature toggle for CPU usage monitoring",
145       "type": "SWITCH",
146       "enum_values": [
147         "ON",
148         "OFF"
149       ],
150       "meter_value_calculation_id": "calc-001",
151       "meter_value_calculation": {
152         "reference": "cpu_usage_sum",
153         "object_type": "calculation",
154         "id": "calc-001",
155         "name": "CPU Usage Sum Calculation",
156         "description": "Sum of CPU usage over time",
157         "calculation_type": "SUM",
158         "persist": true,
159         "meter_id": "meter-001",
160         "meter": {
161           "reference": "cpu_meter",
162           "object_type": "meter",
163           "id": "meter-001",
164           "name": "CPU Meter",
165           "description": "Meter tracking CPU usage",
166           "status": "ACTIVE",
167           "meter_values": [
168             {
169               "id": "mv-001",
170               "object": {
171                 "reference": "cpu_percent",
172                 "object_type": "meter_value",
173                 "id": "mv-001",
174                 "name": "CPU Percentage",
175                 "description": "CPU usage percentage",
176                 "status": "ACTIVE",
177                 "type": "NUMBER"
178               },
179               "required": true
180             }
181           ],
182           "meter_properties": [
183             {
184               "id": "mp-001",
185               "object": {
186                 "reference": "cpu_core_count",
187                 "status": "ACTIVE",
188                 "object_type": "meter_property",
189                 "id": "mp-001",
190                 "name": "CPU Core Count",
191                 "description": "Number of CPU cores",
192                 "type": "NUMBER",
193                 "enum_values": []
194               },
195               "required": true
196             }
197           ]
198         },
199         "meter_value_id": "mv-001",
200         "meter_value": {
201           "reference": "cpu_percent",
202           "object_type": "meter_value",
203           "id": "mv-001",
204           "name": "CPU Percentage",
205           "description": "CPU usage percentage",
206           "status": "ACTIVE",
207           "type": "NUMBER"
208         },
209         "meter_property_id": "mp-001",
210         "meter_property": {
211           "reference": "cpu_core_count",
212           "status": "ACTIVE",
213           "object_type": "meter_property",
214           "id": "mp-001",
215           "name": "CPU Core Count",
216           "description": "Number of CPU cores",
217           "type": "NUMBER",
218           "enum_values": []
219         }
220       }
221     },
222     "threshold": {
223       "number": "90",
224       "percentage": "90",
225       "amount": {
226         "quantity": "0",
227         "currency": "AED"
228       }
229     }
230   },
231   "invoice": {
232     "variant": "OVERDUE",
233     "overdue": {
234       "comparator": "EQUALS",
235       "threshold": {
236         "type": "DAY",
237         "value": 7
238       }
239     }
240   }
241 }

Requires the ALERT_RULE.DELETE permission.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

versionstringRequiredDefaults to 1

version

resourceIdstringRequiredDefaults to

The ID of the resource to be requested.

Response

referencestringformat: "^\S+$"0-256 characters

A custom reference assigned to the alert.

object_typestring or nullRead-only

idstring or nullRead-only

namestring or nullformat: "^.*$"0-256 characters

A custom name assigned to the alert.

descriptionstring or nullformat: "^.*$"0-256 characters

statusenum or null

The status of the AlertRule. DEPRECATED is not supported.

Allowed values:

customer_idslist of strings or null

The IDs of the customers linked to the alert.

customerslist of objects or nullRead-only

typeenum or null

The type of the the alert.

Allowed values:

trigger_typeenum or null

Allowed values:

entitlementobject

The specification of the entitlement for the alert, can only be specified when type is ENTITLEMENT

invoiceobject

The specification of the invoice for the alert, can only be specified when type is INVOICE

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

Authentication

Path parameters

Headers

Response

Errors