Skip to main content
POST
/
uptime
/
status-pages
/
{statusPageId}
Update a status page
curl --request POST \
  --url https://api.phare.io/uptime/status-pages/{statusPageId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Phare status",
  "subdomain": "example",
  "domain": "status.example.com",
  "title": "Phare status",
  "description": "Status page of phare.io",
  "search_engine_indexed": true,
  "website_url": "https://phare.io",
  "color_scheme": "all",
  "theme": {
    "light": {
      "operational": "#16a34a",
      "degraded_performance": "#fbbf24",
      "partial_outage": "#f59e0b",
      "major_outage": "#ef4444",
      "maintenance": "#6366f1",
      "empty": "#d3d3d3",
      "background": "#ffffff",
      "foreground": "#000000",
      "foreground_muted": "#737373",
      "background_card": "#fafafa"
    },
    "dark": {
      "operational": "#16a34a",
      "degraded_performance": "#fbbf24",
      "partial_outage": "#f59e0b",
      "major_outage": "#ef4444",
      "maintenance": "#6366f1",
      "empty": "#d3d3d3",
      "background": "#111111",
      "foreground": "#ffffff",
      "foreground_muted": "#959595",
      "background_card": "#1a1a1a"
    },
    "rounded": true,
    "border_width": 2
  },
  "components": [
    {
      "componentable_id": 123
    }
  ],
  "timeframe": 90,
  "subscription_channels": [],
  "access_ips": [
    "45.129.56.0/24"
  ],
  "logo_light": "<string>",
  "logo_dark": "<string>",
  "favicon_light": "<string>",
  "favicon_dark": "<string>",
  "access_token": "secret",
  "access_password": "secret"
}
'
{
  "name": "Phare status",
  "subdomain": "example",
  "title": "Phare status",
  "description": "Status page of phare.io",
  "search_engine_indexed": true,
  "website_url": "https://phare.io",
  "components": [
    {
      "componentable_id": 123
    }
  ],
  "id": 1,
  "project_id": 1,
  "is_private": false,
  "access_password_enabled": false,
  "access_token_enabled": false,
  "domain": "status.example.com",
  "color_scheme": "all",
  "theme": {
    "light": {
      "operational": "#16a34a",
      "degraded_performance": "#fbbf24",
      "partial_outage": "#f59e0b",
      "major_outage": "#ef4444",
      "maintenance": "#6366f1",
      "empty": "#d3d3d3",
      "background": "#ffffff",
      "foreground": "#000000",
      "foreground_muted": "#737373",
      "background_card": "#fafafa"
    },
    "dark": {
      "operational": "#16a34a",
      "degraded_performance": "#fbbf24",
      "partial_outage": "#f59e0b",
      "major_outage": "#ef4444",
      "maintenance": "#6366f1",
      "empty": "#d3d3d3",
      "background": "#111111",
      "foreground": "#ffffff",
      "foreground_muted": "#959595",
      "background_card": "#1a1a1a"
    },
    "rounded": true,
    "border_width": 2
  },
  "timeframe": 90,
  "subscription_channels": [],
  "access_ips": [
    "45.129.56.0/24"
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.phare.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Use a user token to access authenticated routes. The token must be specified in the Authorization HTTP header with the following format 'Authorization: Bearer '.

Headers

​
X-Phare-Project-Id
integer

A project header is required when using an organization-scoped API key.

Example:

1

​
X-Phare-Project-Slug
string

A project header is required when using an organization-scoped API key.

Example:

"luminous-guiding-tower"

Path Parameters

​
statusPageId
integer
required

ID of the status page to update

Body

application/json

Status page request

​
name
string

Status page name

Example:

"Phare status"

​
subdomain
string

Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io

Example:

"example"

​
domain
string | null

Custom domain name for the status page

Example:

"status.example.com"

​
title
string

Status page HTML title

Example:

"Phare status"

​
description
string

Status page HTML description

Example:

"Status page of phare.io"

​
search_engine_indexed
boolean

Whether search engines are allowed to index the page

Example:

true

​
website_url
string

URL to redirect users clicking the status page logo

Example:

"https://phare.io"

​
color_scheme
enum<string>

Choose the available color schemes for the status page

Available options:
all,
dark,
light
Example:

"all"

​
theme
object

Theme settings to customize the status page

​
components
Monitor component · object[]

List of components to show on the status page

​
timeframe
enum<integer>

Number of days of status and incident history to display.

Available options:
30,
60,
90
Example:

90

​
subscription_channels
enum<string>[]

List of active subscription channels

Maximum array length: 3
Available options:
rss,
atom,
slack
​
access_ips
string[] | null

List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription.

Required array length: 1 - 50 elements
​
logo_light

Manage the light theme logo of the status page (accepted formats: jpeg / png / svg)

​
logo_dark

Manage the dark theme logo of the status page (accepted formats: jpeg / png / svg)

​
favicon_light

Manage the light theme favicon of the status page (accepted formats: png / svg)

​
favicon_dark

Manage the dark theme favicon of the status page (accepted formats: png / svg)

​
access_token
string | null

Token to restrict access to the status page. Requires an active Scale plan subscription.

Required string length: 8 - 500
Example:

"secret"

​
access_password
string | null

Password to restrict access to the status page. Requires an active Scale plan subscription.

Required string length: 8 - 500
Example:

"secret"

Response

Success, status page updated

​
name
string
required

Status page name

Example:

"Phare status"

​
subdomain
string
required

Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io

Example:

"example"

​
title
string
required

Status page HTML title

Example:

"Phare status"

​
description
string
required

Status page HTML description

Example:

"Status page of phare.io"

​
search_engine_indexed
boolean
required

Whether search engines are allowed to index the page

Example:

true

​
website_url
string
required

URL to redirect users clicking the status page logo

Example:

"https://phare.io"

​
components
Monitor component · object[]
required

List of components to show on the status page

​
id
integer

Status page ID

Example:

1

​
project_id
integer

Parent project ID

Example:

1

​
is_private
boolean

Whether the status page requires authentication to access

Example:

false

​
access_password_enabled
boolean

Whether the status page is protected by a password. Requires an active Scale plan subscription.

Example:

false

​
access_token_enabled
boolean

Whether the status page is protected by a secret token. Requires an active Scale plan subscription.

Example:

false

​
domain
string | null

Custom domain name for the status page

Example:

"status.example.com"

​
color_scheme
enum<string>

Choose the available color schemes for the status page

Available options:
all,
dark,
light
Example:

"all"

​
theme
object

Theme settings to customize the status page

​
timeframe
enum<integer>

Number of days of status and incident history to display.

Available options:
30,
60,
90
Example:

90

​
subscription_channels
enum<string>[]

List of active subscription channels

Maximum array length: 3
Available options:
rss,
atom,
slack
​
access_ips
string[] | null

List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription.

Required array length: 1 - 50 elements
​
created_at
string<date-time>

Date of creation for the entity

​
updated_at
string<date-time>

Date of last update for the entity

Last modified on February 8, 2026