Sazabi
APIIntegrations

List integration connections

List integration connections and their connection state for the organization.

GET https://api.sazabi.com/v1/integrations/connections

GET
/integrations/connections

Query Parameters

organizationId?string

Organization to list connections for. Auto-filled from CLI and SDK context when omitted. User tokens must supply it unless the credential's fixed scope resolves it; secret keys may omit it (the key's organization applies).

Length1 <= length
provider?string

Filter connections by provider.

Value in

  • "slack"
  • "github"
  • "linear"
  • "pagerduty"
  • "victorops"
  • "rootly"
  • "incident_io"
  • "webhook"
  • "teams"
  • "bitbucket"
  • "jira"
  • "gitcafe"

Response Body

application/json

curl -X GET "https://example.com/integrations/connections"
{  "connections": [    {      "connectionStatus": {        "state": "connected",        "reasonCode": "credentials_rejected",        "checkedAt": "2019-08-24T14:15:22Z",        "verification": "verified"      },      "recovery": {        "action": "reconnect",        "canCheck": true,        "canDisconnect": true,        "target": {          "kind": "integration",          "resourceId": "string",          "providerId": "string",          "scope": {            "kind": "user",            "id": "string"          }        }      },      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "provider": "slack",      "displayName": "string",      "status": "pending",      "isActive": true,      "needsAttention": true,      "metadata": {        "property1": null,        "property2": null      },      "healthStatus": "healthy",      "healthMessage": "string",      "healthCheckedAt": "2019-08-24T14:15:22Z",      "healthConsecutiveFailures": -9007199254740991,      "connectedBy": "string",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ]}