Skip to main content
POST
List dedicated integrations

Restrictions

Usage

  • These APIs manage channel-owned dedicated integrations; use /integration/* for public integrations.
  • The App Key’s api_scopes must allow the operation; permissions follow the user who owns the key.
  • Private channels also require the account owner, an Admin, the channel creator, or membership in its owning or managing teams; public channels still require the API permission above.
  • channel_id is required; p defaults to 1 and limit defaults to 100, with a maximum of 100.
  • plugin_type and status each accept one value.
  • The complete integration_key is returned; saved secret values in settings are returned as ******. The integration key authenticates alert ingestion and is separate from the management App Key.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Filters and pagination for one channel's dedicated integrations.

channel_id
integer<int64>
required

Channel ID to list dedicated integrations for.

Required range: x >= 1
Example:

20001

p
integer
default:1

Page number, starting at 1.

Required range: x >= 1
limit
integer
default:100

Number of items per page, at most 100.

Required range: 1 <= x <= 100
name
string

Filter by integration name.

Maximum string length: 49
plugin_type
string

Filter by one integration type.

status
enum<string>

Filter by enabled integrations that accept alerts or disabled integrations that pause ingestion.

Available options:
enabled,
disabled

Response

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

One page of dedicated integrations.