Sign in

v1

latestOpenAPI 3.0.02026-07-133916139.4 KB
page

Update a status page

put/page/{id}

Path parameters

idstring required

The id of the page

Example:1

The id of the page

Request body

titlestring

The title of the page

descriptionstring

The description of the page

slugstring

The slug of the page

customDomainstring nullable

The custom domain of the page. To be configured within the dashboard.

passwordProtectedboolean

Deprecated in favor of accessType. Used to set the password protection type. Returns true if accessType is set to 'password' and false otherwise.

accessType'public' | 'password' | 'email-domain'

The access type of the page

passwordstring nullable

Your password to protect the page from the public

authEmailDomainsstring[] nullable

The email domains of the page

showMonitorValuesboolean nullable

Displays the total and failed request numbers for each monitor. Deprecated and will be removed in the future in favor for configuration property.

Example request

{
  "title": "My Page",
  "description": "My awesome status page",
  "slug": "my-page",
  "customDomain": "status.acme.com",
  "passwordProtected": true,
  "accessType": "public",
  "password": "hidden-password",
  "authEmailDomains": [
    "example.com",
    "example.org"
  ],
  "showMonitorValues": true,
  "monitors": [
    1,
    2
  ]
}

Response

Get an Status page

idnumber required

The id of the page

titlestring required

The title of the page

descriptionstring required

The description of the page

slugstring required

The slug of the page

customDomainstring nullable

The custom domain of the page. To be configured within the dashboard.

passwordProtectedboolean

Deprecated in favor of accessType. Used to set the password protection type. Returns true if accessType is set to 'password' and false otherwise.

accessType'public' | 'password' | 'email-domain'

The access type of the page

passwordstring nullable

Your password to protect the page from the public

authEmailDomainsstring[] nullable

The email domains of the page

showMonitorValuesboolean nullable

Displays the total and failed request numbers for each monitor. Deprecated and will be removed in the future in favor for configuration property.

Example response

{
  "id": 1,
  "title": "My Page",
  "description": "My awesome status page",
  "slug": "my-page",
  "customDomain": "status.acme.com",
  "passwordProtected": true,
  "accessType": "public",
  "password": "hidden-password",
  "authEmailDomains": [
    "example.com",
    "example.org"
  ],
  "showMonitorValues": true,
  "monitors": [
    1,
    2
  ]
}