For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integrations

Integrations endpoints

Get the integrations

get
/status_pages/{subdomain}/integrations
Authorizations
AuthorizationstringRequired
Path parameters
subdomainstringRequired

The subdomain of your status page.

You can find this under your status page settings, the Subdomain field is found under the "Domain name" section. Alternatively find it in the URL of your admin dashboard (e.g. statuspal.io/admin/subdomain).

Responses
200

A status page's integrations

application/json
get/status_pages/{subdomain}/integrations
GET /api/v2/status_pages/{subdomain}/integrations HTTP/1.1
Host: statuspal.io
Authorization: YOUR_API_KEY
Accept: */*
{
  "integrations": [
    {
      "id": 1,
      "name": "newrelic",
      "user": "123456",
      "phone_number": "+1234567890",
      "domain": "example.com",
      "email_from_address": "notifications@example.com",
      "key": "your-api-key",
      "relay": "smtp.example.com",
      "username": "smtp-user@smtp.example.com",
      "port": 25,
      "region": "us",
      "settings": {
        "enabled": true,
        "api_key_type": "private"
      }
    }
  ]
}

Adds a new integration

post
/status_pages/{subdomain}/integrations
Authorizations
AuthorizationstringRequired
Path parameters
subdomainstringRequired

The subdomain of your status page.

You can find this under your status page settings, the Subdomain field is found under the "Domain name" section. Alternatively find it in the URL of your admin dashboard (e.g. statuspal.io/admin/subdomain).

Body
Responses
201

The integration created

application/json
post/status_pages/{subdomain}/integrations
POST /api/v2/status_pages/{subdomain}/integrations HTTP/1.1
Host: statuspal.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 364

{
  "integration": {
    "name": "newrelic",
    "user": "123456",
    "phone_number": "+1234567890",
    "domain": "example.com",
    "email_from_address": "notifications@example.com",
    "key": "your-api-key",
    "password": "your-password",
    "relay": "smtp.example.com",
    "username": "smtp-user@smtp.example.com",
    "port": 25,
    "region": "us",
    "settings": {
      "__type__": "common",
      "enabled": true,
      "api_key_type": "private"
    }
  }
}
{
  "integration": {
    "id": 1,
    "name": "newrelic",
    "user": "123456",
    "phone_number": "+1234567890",
    "domain": "example.com",
    "email_from_address": "notifications@example.com",
    "key": "your-api-key",
    "relay": "smtp.example.com",
    "username": "smtp-user@smtp.example.com",
    "port": 25,
    "region": "us",
    "settings": {
      "enabled": true,
      "api_key_type": "private"
    }
  }
}

Get integration against given integration id

get
/status_pages/{subdomain}/integrations/{integrationId}
Authorizations
AuthorizationstringRequired
Path parameters
subdomainstringRequired

The subdomain of your status page.

You can find this under your status page settings, the Subdomain field is found under the "Domain name" section. Alternatively find it in the URL of your admin dashboard (e.g. statuspal.io/admin/subdomain).

integrationIdintegerRequired

The ID of integration

Responses
200

The integration details

application/json
get/status_pages/{subdomain}/integrations/{integrationId}
GET /api/v2/status_pages/{subdomain}/integrations/{integrationId} HTTP/1.1
Host: statuspal.io
Authorization: YOUR_API_KEY
Accept: */*
{
  "integration": {
    "id": 1,
    "name": "newrelic",
    "user": "123456",
    "phone_number": "+1234567890",
    "domain": "example.com",
    "email_from_address": "notifications@example.com",
    "key": "your-api-key",
    "relay": "smtp.example.com",
    "username": "smtp-user@smtp.example.com",
    "port": 25,
    "region": "us",
    "settings": {
      "enabled": true,
      "api_key_type": "private"
    }
  }
}

Updates existing integration

put
/status_pages/{subdomain}/integrations/{integrationId}
Authorizations
AuthorizationstringRequired
Path parameters
integrationIdintegerRequired

The ID of integration

subdomainstringRequired

The subdomain of your status page.

You can find this under your status page settings, the Subdomain field is found under the "Domain name" section. Alternatively find it in the URL of your admin dashboard (e.g. statuspal.io/admin/subdomain).

Body
Responses
200

The integration updated

application/json
put/status_pages/{subdomain}/integrations/{integrationId}
PUT /api/v2/status_pages/{subdomain}/integrations/{integrationId} HTTP/1.1
Host: statuspal.io
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 364

{
  "integration": {
    "name": "newrelic",
    "user": "123456",
    "phone_number": "+1234567890",
    "domain": "example.com",
    "email_from_address": "notifications@example.com",
    "key": "your-api-key",
    "password": "your-password",
    "relay": "smtp.example.com",
    "username": "smtp-user@smtp.example.com",
    "port": 25,
    "region": "us",
    "settings": {
      "__type__": "common",
      "enabled": true,
      "api_key_type": "private"
    }
  }
}
{
  "integration": {
    "id": 1,
    "name": "newrelic",
    "user": "123456",
    "phone_number": "+1234567890",
    "domain": "example.com",
    "email_from_address": "notifications@example.com",
    "key": "your-api-key",
    "relay": "smtp.example.com",
    "username": "smtp-user@smtp.example.com",
    "port": 25,
    "region": "us",
    "settings": {
      "enabled": true,
      "api_key_type": "private"
    }
  }
}

Deletes integration permanently

delete
/status_pages/{subdomain}/integrations/{integrationId}
Authorizations
AuthorizationstringRequired
Path parameters
subdomainstringRequired

The subdomain of your status page.

You can find this under your status page settings, the Subdomain field is found under the "Domain name" section. Alternatively find it in the URL of your admin dashboard (e.g. statuspal.io/admin/subdomain).

integrationIdintegerRequired

The ID of integration

Responses
200

Integration deleted successfully

delete/status_pages/{subdomain}/integrations/{integrationId}
DELETE /api/v2/status_pages/{subdomain}/integrations/{integrationId} HTTP/1.1
Host: statuspal.io
Authorization: YOUR_API_KEY
Accept: */*

No content

Last updated