Skip to main content
GET
Get an alert integration

Authorizations

Authorization
string
header
required

Organization API key (sl_…).

Headers

x-tenant-id
string
required

The organization ID the request is scoped to.

Path Parameters

alert_integration_id
string
required

Response

Successful Response

A connection to an external system SELECT sends alerts through.

id
string
required
read-only

Opaque identifier for this integration. Set when the integration is connected and immutable afterward.

etag
string
required
read-only

Opaque strong ETag for this integration's configuration. Matches the ETag response header, and is what If-Match requires on a write. It changes whenever a configurable field on the integration changes.

display_name
string
required

Display name for the integration, as shown throughout SELECT.

integration_type
enum<string>
required
read-only

The external system this integration connects to. Set by which connect flow created the integration and immutable afterward.

Available options:
slack,
email,
ms_teams_webhook
status
enum<string>
required
read-only

Current status of SELECT's connection to this integration.

Available options:
unknown,
pending,
failing,
connected
credentials_configured
boolean
required
read-only

Whether SELECT holds credentials for this integration. The credentials themselves are never returned.

create_time
string
required
read-only

When the integration was connected, as an RFC 3339 UTC timestamp.

update_time
string
required
read-only

When the integration was last changed, as an RFC 3339 UTC timestamp.

last_verified_time
string | null

When SELECT last verified the integration's credentials, as an RFC 3339 UTC timestamp. Null if they have not been verified.

last_used_time
string | null

When a destination under this integration last sent an alert, as an RFC 3339 UTC timestamp. Null if none has yet.

slack_workspace_id
string | null

Identifier of the connected Slack workspace. Null for non-Slack integrations.

slack_workspace_name
string | null

Display name of the connected Slack workspace. Null for non-Slack integrations.