v1

latestOpenAPI 3.0.1Apache 2.02026-08-063494581.6 MB
esper_cloud_api_Alerts

List alert channels in enterprise

⚠️ Android only.

Returns a paginated list of all alert channels configured in the enterprise. Alert channels define the destinations where alert notifications are sent when alarm rules are triggered — currently supporting email as the delivery type. Use this endpoint to discover channel IDs for associating with alarm rules, or to audit existing notification destinations.

Common use cases

Retrieving channel IDs to associate with new or existing alarm rules

Auditing notification destinations across the enterprise

Verifying which alarm rules are linked to a given channel before updating or deleting it

Best practices

Check linked_alerts in the response before deleting a channel — removing a channel that is actively linked to alarm rules will affect those rules' notification delivery

Use the name filter to quickly locate a specific channel without paginating through all results

Note that id is an integer, not a UUID — use it as-is in subsequent calls to GET, PUT, PATCH, or DELETE on /alertchannels/{alert_id}

get/v1/enterprise/{enterprise_id}/alertchannels/

Path parameters

enterprise_idstring required

A UUID string identifying this enterprise.

Query parameters

namestring

Filter alert channels by name.

limitinteger

Number of results to return per page.

offsetinteger

Return results from this index.

Response

successful operation

countinteger required
nextstring url nullable
previousstring url nullable