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

Status Page Members

Status Page Members endpoints

List all members

get
/status_pages/{subdomain}/members
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).

Query parameters
beforestringOptional

Used as a cursor for pagination.

afterstringOptional

Used as a cursor for pagination.

limitintegerOptional

Set the number of subscriptions to return in the response. This defaults to 20 items, and can be a maximum of 100.

emailstringOptional

Filter the members by email.

Responses
200

The list of members

application/json
get/status_pages/{subdomain}/members
GET /api/v2/status_pages/{subdomain}/members HTTP/1.1
Host: statuspal.io
Authorization: YOUR_API_KEY
Accept: */*
{
  "members": [
    {
      "id": 5,
      "email": "jane@doe.com",
      "role": "v",
      "enabled": true,
      "user": {
        "id": 1,
        "last_sign_in_at": "2022-01-01T00:00:00",
        "current_sign_in_at": "2022-01-01T00:00:00"
      },
      "inserted_at": "2022-01-01T00:00:00",
      "updated_at": "2022-01-01T00:00:00"
    }
  ],
  "links": {
    "next": "{STATUSPAL_HOST}/api/v2/status_pages/subdomain/members?after=cUrSoR",
    "prev": "text"
  },
  "meta": {
    "total_count": 100
  }
}

Adds a new membership

post
/status_pages/{subdomain}/members
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
200

The membership was created

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

{
  "member": {
    "email": "jane@doe.com",
    "role": "v",
    "enabled": true,
    "lang": "en"
  }
}
{
  "member": {
    "id": 5,
    "email": "jane@doe.com",
    "role": "v",
    "enabled": true,
    "user": {
      "id": 1,
      "last_sign_in_at": "2022-01-01T00:00:00",
      "current_sign_in_at": "2022-01-01T00:00:00"
    },
    "inserted_at": "2022-01-01T00:00:00",
    "updated_at": "2022-01-01T00:00:00"
  }
}

Update the membership

put
/status_pages/{subdomain}/members/{memberId}
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).

memberIdintegerRequired

The ID of a membership

Body
Responses
200

The membership was updated

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

{
  "member": {
    "role": "v",
    "enabled": true
  }
}
{
  "member": {
    "id": 5,
    "email": "jane@doe.com",
    "role": "v",
    "enabled": true,
    "user": {
      "id": 1,
      "last_sign_in_at": "2022-01-01T00:00:00",
      "current_sign_in_at": "2022-01-01T00:00:00"
    },
    "inserted_at": "2022-01-01T00:00:00",
    "updated_at": "2022-01-01T00:00:00"
  }
}

Deletes the membership

delete
/status_pages/{subdomain}/members/{memberId}
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).

memberIdintegerRequired

The ID of a membership

Responses
204

Member deleted successfully

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

No content

Last updated