Skip to main content
GET
/
v1
/
integrations
/
catalog
Integration catalog
curl --request GET \
  --url https://api.example.com/v1/integrations/catalog \
  --header 'Authorization: <authorization>'

​
Overview

Returns the full catalog of integrations available to connect. Each entry describes the provider, required credentials, and OAuth scopes needed. Authentication: Public endpoint — no JWT required for browsing the catalog.

​
Request headers

​
Authorization
string
required
JWT Bearer token. Format: Bearer <your-jwt>.

​
Query parameters

​
category
string
Filter by integration category. One of: monitoring, code, ticketing, communication, cloud.

​
Response

Returns 200 OK. 
{
  "items": [
    {
      "provider": "github",
      "displayName": "GitHub",
      "category": "code",
      "description": "Connect GitHub to correlate deployments with incidents and fetch code context.",
      "authType": "oauth2",
      "scopes": ["repo", "read:org"],
      "connectUrl": "https://api.causeflow.ai/v1/integrations/connect/github"
    },
    {
      "provider": "datadog",
      "displayName": "Datadog",
      "category": "monitoring",
      "description": "Pull metrics and logs from Datadog for AI-enriched investigations.",
      "authType": "api_key",
      "requiredFields": ["api_key", "application_key"],
      "connectUrl": "https://api.causeflow.ai/v1/integrations/connect/datadog"
    },
    {
      "provider": "pagerduty",
      "displayName": "PagerDuty",
      "category": "monitoring",
      "description": "Sync PagerDuty incidents and escalation policies with CauseFlow.",
      "authType": "oauth2",
      "scopes": ["read", "write"],
      "connectUrl": "https://api.causeflow.ai/v1/integrations/connect/pagerduty"
    }
  ],
  "total": 14
}
FieldTypeDescription
providerstringUnique provider key
displayNamestringHuman-readable provider name
categorystringIntegration category
descriptionstringWhat this integration provides
authTypestringAuthentication method: oauth2, api_key, webhook_only
scopesstring[]OAuth scopes (for oauth2 providers)
requiredFieldsstring[]Required credential fields (for api_key providers)
connectUrlstringURL to initiate the connection flow

​
Error responses

StatusError codeDescription
429rate_limit_exceededToo many catalog requests

​
Examples

curl "https://api.causeflow.ai/v1/integrations/catalog?category=monitoring"

Connect integration

Connect an integration from the catalog

List integrations

View already-connected integrations