OPopenobserve
Alerts

List alert destinations

Retrieves a list of all alert destinations configured for an organization. Optionally filter by module type (alert or pipeline) to get specific destination categories. Returns destination names, types, and basic configuration details to help administrators manage notification routing and review available delivery options. Destinations the caller may not PUT come with the URL cut to its origin and header values and credential metadata blanked.

get/api/{org_id}/alerts/destinations

Request

Path parameters

org_idstring required

Organization name

Query parameters

modulestring

Destination module filter, none, alert, or pipeline

include_usageboolean

When true, each destination carries the consumers that reference it

Response

Success

auto_investigate'off' | 'critical'
buttonsboolean nullable

Acknowledge, Mute and Investigate on each message; default true.

channel_idstring nullable
channel_namestring nullable
installation_idstring nullable
oncall_room_confirmedboolean nullable

Required true when an on-call team pages into this channel through a Slack webhook.

previous_webhookobject nullable

The webhook a switch replaced, kept so it can be switched back; never sent to.

refire_reuse_minutesinteger nullable

0 to 240; default 30.

shared_channel_confirmedboolean nullable

Required true when the channel is shared with another company.

aws_regionstring nullable

AWS region for SNS destinations. Required when type is sns.

destination_type_namestring nullable

Specific destination type identifier (e.g., "openobserve", "splunk", "elasticsearch").

emailsstring[]

Email recipients for Email destinations. Required when type is email.

headersobject nullable

Optional HTTP headers for webhook requests; values read back blank without PUT.

metadataobject

Optional key-value metadata; without PUT, values outside the known plain keys read blank.

method'post' | 'put' | 'get'
namestring

Unique name for this destination. Must be unique within the organization.

skip_tls_verifyboolean

Whether to skip TLS certificate verification for HTTP destinations.

sns_topic_arnstring nullable

SNS topic ARN for SNS destinations. Required when type is sns.

templatestring nullable

REQUIRED for alert destinations. Name of the template to use for formatting alert messages. Use "Default" for the built-in default template. Without a template, the destination becomes a pipeline destination and cannot be used with alerts.

type'http' | 'email' | 'sns' | 'slack_app'
urlstring

Webhook URL, required for http; without PUT, its origin, or empty for a keyed host.

Example response

[
  {
    "channel_id": "C0FAKE00001",
    "name": "my_alert_webhook",
    "template": "Default",
    "url": "https://example.com/webhook"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.