Skip to main content
POST
List public integrations

Restrictions

Usage

  • orderby defaults to created_at; plugin_type sorts by the underlying plugin. Rows are ordered by ref_id first, so orderby applies within each ref_id group.
  • plugin_type, status and category accept comma-separated values; ref_ids values must start with c_, a_ or w_; a c_ filter is syntactically accepted but does not return channel-owned integrations.
  • With is_my_team set, results are limited to your teams and team_ids narrows that set further; when you belong to no team, or team_ids shares no team with yours, the list is empty.
  • These APIs manage public (account-level) integrations only, not channel-owned dedicated integrations.
  • Items include settings, integration_key, plugin_id, account_id, and the legacy data_source_id alias. Saved secret values in settings are returned as ******; integration_key is returned as is.

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

Filter parameters for listing integrations.

p
integer
default:1

Page number, 1-based.

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

Page size. Defaults to 100, maximum 100.

Required range: 1 <= x <= 100
orderby
enum<string>

Sort field. Defaults to created_at; plugin_type is sorted by the underlying plugin.

Available options:
created_at,
updated_at,
name,
plugin_type,
status
category
string

Comma-separated category filter. Values: event.alert (alert events), event.change (change events), im (IM bots), webhook (custom webhooks). Unknown values are not rejected and match nothing.

type
string

Deprecated alias of plugin_type (comma-separated type keys such as prometheus.alert, zabbix.alert). Ignored when plugin_type is also set.

plugin_type
string

Comma-separated integration type keys, for example standard.alert,prometheus.alert; the keys are the plugin_type values from POST /integration/type/list.

status
string

Comma-separated status filter: enabled (accepting events) and/or disabled (paused).

name
string

Filter by integration name; matches any name that contains this text.

ref_ids
string[]

Filter by source reference IDs. Each value must start with c_ (channel), a_ (account) or w_.

asc
boolean

Sort ascending when true, descending when false.

is_my_team
boolean

Limit the result to integrations owned by your teams.

team_ids
integer<int64>[]

Filter by team IDs. With is_my_team, the values narrow that set further.

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

A page of integrations.