API documentation
Alert
Customer
- GETList customers
- POSTCreate customer
- GETFetch customer by external ID
- PUTUpdate customer by external ID
- GETFetch customer costs by external ID
- POSTUpdate payment methods from payment provider
- GETFetch customer
- PUTUpdate customer
- DELDelete customer
- GETList balance transactions
- POSTCreate customer balance transaction
- GETFetch customer costs
- POSTUpdate payment methods from payment provider
Credit
- GETFetch customer credit balance by external customer id
- GETFetch customer credits ledger by external ID
- POSTCreate ledger entry by external ID
- GETList top-ups by external ID
- POSTCreate top-up by external ID
- DELDeactivate top-up by external ID
- GETFetch customer credit balance
- GETFetch customer credits ledger
- POSTCreate ledger entry
- GETList top-ups
- POSTCreate top-up
- DELDeactivate top-up
Dimensional Price Group
Event
Invoice
Availability
Plan
Price
Subscription Change
Subscription
- GETList subscriptions
- POSTCreate subscription
- GETFetch subscription
- PUTUpdate subscription
- POSTCancel subscription
- GETFetch subscription costs
- GETFetch subscription schedule
- POSTSchedule plan change
- POSTTrigger phase
- POSTUnschedule subscription cancellation
- POSTUnschedule fixed fee quantity updates
- POSTUnschedule plan change
- POSTUpdate price quantity
- POSTUpdate trial for subscription
- GETFetch subscription usage
Price interval
Alert
Disable alert by ID
This endpoint allows you to disable an alert. To disable a plan-level alert for a specific subscription, you must include
the subscription_id
. The subscription_id
is not required for customer or subscription level alerts.
POST
/
alerts
/
{alert_configuration_id}
/
disable
curl --request POST \
--url https://api.withorb.com/v1/alerts/{alert_configuration_id}/disable \
--header 'Authorization: Bearer <token>'
{
"id": "XuxCbt7x9L82yyeF",
"type": "\"usage_exceeded\", \"cost_exceeded\", \"credit_balance_depleted\", \"credit_balance_recovered\", or \"credit_balance_dropped\"",
"created_at": "2023-11-07T05:31:56Z",
"enabled": true,
"thresholds": [
{
"value": 123
}
],
"customer": {
"id": "<string>",
"external_customer_id": "<string>"
},
"plan": {
"id": "m2t5akQeh2obwxeU",
"external_plan_id": "m2t5akQeh2obwxeU",
"name": "Example plan",
"plan_version": "<string>"
},
"subscription": {
"id": "VDGsT23osdLb84KD"
},
"metric": {
"id": "<string>"
},
"currency": "<string>",
"balance_alert_status": [
{
"threshold_value": 123,
"in_alert": true
}
]
}
Authorizations
API Keys can be issued in the Orb's web application.
Path Parameters
Query Parameters
Used to update the status of a plan alert scoped to this subscription_id
Response
200
application/json
OK
Alerts within Orb monitor spending, usage, or credit balance and trigger webhooks when a threshold is exceeded.
Alerts created through the API can be scoped to either customers or subscriptions.
Was this page helpful?
curl --request POST \
--url https://api.withorb.com/v1/alerts/{alert_configuration_id}/disable \
--header 'Authorization: Bearer <token>'
{
"id": "XuxCbt7x9L82yyeF",
"type": "\"usage_exceeded\", \"cost_exceeded\", \"credit_balance_depleted\", \"credit_balance_recovered\", or \"credit_balance_dropped\"",
"created_at": "2023-11-07T05:31:56Z",
"enabled": true,
"thresholds": [
{
"value": 123
}
],
"customer": {
"id": "<string>",
"external_customer_id": "<string>"
},
"plan": {
"id": "m2t5akQeh2obwxeU",
"external_plan_id": "m2t5akQeh2obwxeU",
"name": "Example plan",
"plan_version": "<string>"
},
"subscription": {
"id": "VDGsT23osdLb84KD"
},
"metric": {
"id": "<string>"
},
"currency": "<string>",
"balance_alert_status": [
{
"threshold_value": 123,
"in_alert": true
}
]
}