How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ControlUp Alerts API

Alerts let you receive notifications or automatically run an action when certain conditions occur on a device.

ControlUp Alerts API is one of 61 APIs that ControlUp publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Alerts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 13 operations across 7 paths, and defines 96 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 3 base URLs: https://api.controlup.com/edge/api, https://api.controlup.com/events/v1/alerts, https://api.controlup.com/synthetic-monitoring/v2/.

13 operations 7 paths 96 schemas 2 DELETE7 GET1 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.controlup.com/v1
Authentication
HTTP Bearer, HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 3

ControlUp Alerts API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It accepts HTTP bearer tokens (apiKey). It accepts HTTP bearer tokens (ApiKeyAuth).

Paths & Operations 13

Across 7 paths, the API surfaces 13 operations — 2 DELETE, 7 GET, 1 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Alerts 13

Alerts let you receive notifications or automatically run an action when certain conditions occur on a device.

GET
/alerts
List all Alerts
get-alerts 9 params → 200400401403
POST
/alerts
Create an Alert
create-alert body → 200401403
GET
/alerts/{id}
Retrieve Alert
get-alert 1 param → 200401403
POST
/alerts/{id}
Edit alert
edit-alert 1 param body → 200401403
DELETE
/alerts/{id}
Delete alert
delete-alert 1 param → 200401403
GET
/organizations/{orgId}/alert-configs
List all Alerts
AlertsConfigsController_getAll 7 params → 200400401403404500
GET
/alerts/scouts
List Scout IDs with alerts
honeycomb.api.get_scout_alerts 2 params → 200400401500
GET
/alerts/{scoutId}
List alerts for a Scout
app.get_alert_for_scout 4 params → 200400401500
GET
/scouts/{scoutId}/alerts
List alert policies for a Scout
app.get_scout_alert_policies 1 param → 200400401404500
POST
/scouts/{scoutId}/alerts
Create alert policy
app.create_scout_alert 1 param body → 201400401404500
GET
/scouts/{scoutId}/alerts/{alertId}
Get alert policy details
app.get_scout_alert 2 params → 200400401404500
PATCH
/scouts/{scoutId}/alerts/{alertId}
Update alert policy
app.update_scout_alert 2 params body → 200400401404500
DELETE
/scouts/{scoutId}/alerts/{alertId}
Delete alert policy
app.delete_scout_alert 2 params → 204400401404500

Schemas 96

The contract defines 96 schemas that model the data the API accepts and returns. The most detailed are Alert (22 properties), JsonApiError (6 properties), PaginatedResponseMetadata (5 properties), AlertWebhookNotification (5 properties). Each schema is shown below with its type and property counts.

AlertConditionGroupTraceroute
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
ErrorCode.Forbidden
number
AlertTerminalRuleWebTransactions
object
A single alert condition that evaluates a test result property.
3 properties
Alert
object
22 properties
AlertConditionObjectCitrix
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
AlertConditionObjectAvd
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
AlertConditionObjectTeams
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
AlertTerminalRuleCitrixCloud
object
A single alert condition that evaluates a test result property.
3 properties
HttpStatusCode.NOT_FOUND
number
AlertDetails
Detailed information about an alert policy for a Scout.
AlertTriggerSettings
object
Settings that control when and how alerts are triggered.
5 properties
AlertConditionObjectCitrixStorefront
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
AlertConditionGroupAzureAd
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
ErrorResponseBody_ErrorType_ErrorMessage.Unauthorized.HttpStatusCode.UNAUTHORIZED.ErrorCode.Unauthorized__
object
2 properties 2 required
ErrorType_ErrorMessage.NotFound.HttpStatusCode.NOT_FOUND.ErrorCode.NotFound_
object
4 properties 3 required
PaginatedResponseMetadata
object
5 properties 5 required
SubType
object
1 property
AlertConditionGroupCitrix
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
ErrorType_ErrorMessage.InternalServerError.HttpStatusCode.INTERNAL_SERVER_ERROR.ErrorCode.InternalServerError_
object
4 properties 3 required
AlertConditionGroupCitrixStorefront
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
AlertTerminalRuleTraceroute
object
A single alert condition that evaluates a test result property.
3 properties
ErrorMessage.Unauthorized
string
AlertConditionObjectDns
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
AlertConditionObjectVmware
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
AlertTerminalRuleAvd
object
A single alert condition that evaluates a test result property.
3 properties
ErrorMessage.InternalServerError
string
AlertTerminalRuleExchange
object
A single alert condition that evaluates a test result property.
3 properties
HttpStatusCode.FORBIDDEN
number
AlertConditionGroupDns
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
AlertMetadataDTO
ErrorResponseBody_ErrorType_BadRequestErrorMessages.HttpStatusCode.BAD_REQUEST.BadRequestErrorCodes__
object
2 properties 2 required
HttpStatusCode.BAD_REQUEST
number
UUID
string
Stringified UUIDv4. See [RFC 4112](https://tools.ietf.org/html/rfc4122)
MarshmallowError
object
1 property
SourceName
string
AlertTerminalRuleDns
object
A single alert condition that evaluates a test result property.
3 properties
AlertNotification
Notifications sent when the Scout triggers the alert. If no notifications are selected, you can still view each time the alert has triggered using the API endp…
AlertConditions
Defines the test results that trigger an alert. Select your Scout type to see how to create conditions for that Scout type.
AlertTerminalRulePing
object
A single alert condition that evaluates a test result property.
3 properties
AlertTerminalRuleShell
object
A single alert condition that evaluates a test result property.
3 properties
AlertTerminalRuleHttp
object
A single alert condition that evaluates a test result property.
3 properties
ErrorResponseBody_ErrorType_ErrorMessage.Forbidden.HttpStatusCode.FORBIDDEN.ErrorCode.Forbidden__
object
2 properties 2 required
AlertConditionObjectPing
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
JsonApiError
object
Error object
6 properties 4 required
AlertTerminalRuleResponse
object
A single alert condition that evaluates a test result property.
3 properties
AlertConditionObjectSiteload
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
AlertIntegrationNotification
object
2 properties 2 required
AlertConditionGroupCitrixCloud
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
AlertConditionGroupWebTransactions
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
AlertConditionObjectCitrixCloud
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
ErrorResponseMetadata
object
4 properties 4 required
ErrorType_BadRequestErrorMessages.HttpStatusCode.BAD_REQUEST.BadRequestErrorCodes_
object
4 properties 3 required
AlertConditionObjectHttp
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
AlertConditionObjectExchange
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
ErrorType_ErrorMessage.Unauthorized.HttpStatusCode.UNAUTHORIZED.ErrorCode.Unauthorized_
object
4 properties 3 required
Severity
string
ErrorCode.Unauthorized
number
AlertConditionObjectTraceroute
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
BaseError
object
1 property 1 required
AlertConditionGroupVmware
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
AlertConditionObjectWebTransactions
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
AlertTerminalRuleSiteload
object
A single alert condition that evaluates a test result property.
3 properties
AlertConditionGroupExchange
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
AlertConditionGroupTeams
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
HttpStatusCode.UNAUTHORIZED
number
AlertSummary
object
Summary information about an alert policy for a Scout.
5 properties 4 required
AlertConditionGroupSiteload
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
AlertCreateRequest
object
Request schema for creating a new alert for a Scout
3 properties 1 required
ErrorResponseBody_ErrorType_ErrorMessage.InternalServerError.HttpStatusCode.INTERNAL_SERVER_ERROR.ErrorCode.InternalServerError__
object
2 properties 2 required
AlertItem
Details of the Scout's alert configuration and each time the alert was triggered.
BadRequestErrorCodes
number
AlertConditionObjectShell
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
AlertConditionGroupAvd
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
ErrorCode.NotFound
number
ErrorType_ErrorMessage.Forbidden.HttpStatusCode.FORBIDDEN.ErrorCode.Forbidden_
object
4 properties 3 required
ErrorMessage.Forbidden
string
AlertConditionGroupShell
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
APIResponse_AlertMetadataDTO-Array_
object
1 property 1 required
AlertConditionGroupPing
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
AlertTerminalRuleAzureAd
object
A single alert condition that evaluates a test result property.
3 properties
AlertTerminalRuleVmware
object
A single alert condition that evaluates a test result property.
3 properties
AlertConditionGroupHttp
object
Group of conditions or condition groups with AND/OR operators. Supports nesting up to 5 levels deep.
2 properties 2 required
APIPaginatedResponse_AlertMetadataDTO-Array_
BadRequestErrorMessages
string
AlertConditionObjectAzureAd
To create an Alert policy based on a single condition (for example, status == 'failure'), select Condition. To create an Alert policy based on multiple conditi…
ErrorCode.InternalServerError
number
AlertTerminalRuleTeams
object
A single alert condition that evaluates a test result property.
3 properties
AlertWebhookNotification
object
5 properties 2 required
HttpStatusCode.INTERNAL_SERVER_ERROR
number
ErrorResponseBody_ErrorType_ErrorMessage.NotFound.HttpStatusCode.NOT_FOUND.ErrorCode.NotFound__
object
2 properties 2 required
ErrorMessage.NotFound
string
AlertTerminalRuleCitrix
object
A single alert condition that evaluates a test result property.
3 properties
AlertConfigBaseDTO
object
5 properties 4 required
AlertUpdateRequest
object
Request schema for updating an alert for a Scout
4 properties
AlertTerminalRuleCitrixStorefront
object
A single alert condition that evaluates a test result property.
3 properties
AlertEmailNotification
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

controlup-alerts-api-openapi.yml Raw ↑

Other APIs ControlUp publishes across the network.

ControlUp MCP Server
ControlUp Alerts - Devices API
ControlUp Applications API
ControlUp Audit Log API
ControlUp Cloud providers API
ControlUp Dal API
ControlUp Data API
ControlUp Devices API
ControlUp Dynamic Query API API
ControlUp Events API
ControlUp Features API
ControlUp Health API
Where this information came from

This is an independent, third-party profile of ControlUp Alerts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.