Integrations

Integration setup specifications for programmatic onboarding.

List Integrations

Returns all integrations for the given instance, including type, name, status, API key, collector domains, and categories.

Create Integrations

Create a new integration. The `typeSpecificData` payload shape depends on the parent `type` field; for `CLOUDWATCH_METRIC_PULL`, populate `cloudWatchMetricPullIntegration` with the AWS account ID, IAM role ARN, external ID, regions, and resource-type filters. The backend validates IAM role assumption synchronously before persisting.

Delete Integration

Delete an integration.

Get Integration

Get an integration by ID.

Patch Integration

Update an integration. Only fields present in the request body are modified. For `CLOUDWATCH_METRIC_PULL`, the backend re-validates IAM role assumption if the role ARN or external ID changes.

Update Integration

Verb alias of PATCH. Same body shape and semantics.

Get integration setup spec

Returns the structured setup specification for the given integration type. Contains requirements, parameters, setup methods with step-by-step instructions, config templates, and validation hints. No authentication required.

List integration setup specs

Returns a list of all available integration types that have a setup spec. Each entry contains the type slug and description. Includes aliases. No authentication required.