Status Pages

Create and manage status pages within your accounts.

Get all status pages

bash

curl -u AUTH_TOKEN: https://app.honeybadger.io/v2/accounts/ACCOUNT_ID/status_pages

Returns a list of all status pages in this account.

json

  

{
  "results": [
    {
      "id": "rMGSZB",
      "name": "My Awesome Status Page",
      "account_id": "Me3upk",
      "domain": "your.custom.domain",
      "url": "your.custom.domain",
      "created_at": "2022-01-29T11:26:19.120153Z",
      "domain_verified_at": "2022-01-29T14:02:32.570227Z",
      "sites": [],
      "check_ins": [
        {
          "check_in_id": "XXXXXX",
          "display_name": "Nightly billing",
          "state": "reporting",
          "reported_at": "2022-01-29T00:00:02.523254Z"
        }
      ]
    },
    {
      "id": "vWbSWr",
      "name": "Really Awesome Status Page",
      "account_id": "Me3upk",
      "domain": null,
      "url": "vWbSWr.status.hbuptime.com",
      "created_at": "2022-01-29T11:09:32.570227Z",
      "domain_verified_at": null,
      "sites": [
        {
          "site_id": "7d25f58b-d1a9-49f1-b10a-ac7ee44a6537",
          "display_name": "Main site",
          "state": "up",
          "last_checked_at": "2022-01-29T11:09:30.982801Z"
        },
        {
          "site_id": "7d25f58b-d1a9-49f1-b10a-ac7ee44a6557",
          "display_name": "API",
          "state": "up",
          "last_checked_at": "2022-01-29T11:04:28.675309Z"
        }
      ],
      "check_ins": []
    }
  ],
  "links": {
    "self": "http://localhost:3000/v2/accounts/4bYurk/status_pages"
  }
}

Get a single status page's details

bash

curl -u AUTH_TOKEN: https://app.honeybadger.io/v2/accounts/ACCOUNT_ID/status_pages/ID

json

  

{
  "id": "vWbSWr",
  "name": "Really Awesome Status Page",
  "account_id": "Me3upk",
  "domain": null,
  "url": "vWbSWr.status.hbuptime.com",
  "created_at": "2022-01-29T11:09:32.570227Z",
  "domain_verified_at": null,
  "sites": [
    {
      "site_id": "7d25f58b-d1a9-49f1-b10a-ac7ee44a6537",
      "display_name": "Main site",
      "state": "up",
      "last_checked_at": "2022-01-29T11:09:30.982801Z"
    },
    {
      "site_id": "7d25f58b-d1a9-49f1-b10a-ac7ee44a6557",
      "display_name": "API",
      "state": "up",
      "last_checked_at": "2022-01-29T11:04:28.675309Z"
    }
  ],
  "check_ins": []
}

Create a status page

bash

  

curl -u AUTH_TOKEN: -X POST -H 'Content-type: application/json' \
  -d '{
        "status_page": {
            "name": "Really Awesome Status Page",
            "domain": "your.custom.domain",
            "sites": [
              {
                "site_id": "7d25f58b-d1a9-49f1-b10a-ac7ee44a6537",
                "display_name": "Main site"
              }
            ]
        }
    }' https://app.honeybadger.io/v2/accounts/ACCOUNT_ID/status_pages

You can specify these fields within the status page object:

Field name	Type	Description
name	string	The name of the status page
domain	string	(Optional) A custom domain for the status page. Setting this will trigger the domain DNS verification check.
sites	object[]	(Optional) Details of sites to add to this status page. Each object references a site in a project in this account, and must contain the `site_id` and an optional `display_name` and `position`. The `position` field is a zero-indexed integer that controls how your sites will be ordered on the status page.
check_ins	object[]	(Optional) Details of check-ins to add to this status page. Each object references a check-in in a project in this account, and must contain the `check_in_id` and an optional `display_name` and `position`. The `position` field is a zero-indexed integer that controls how your check-ins will be ordered on the status page.
hide_branding	boolean	Whether or not to hide the Honeybadger branding in the footer of the status page. Only available on the Team plan and above.
features	object	Additional customization options only available on the Team plan and above. Available options: `home_link`: URL to hyperlink the status page title or logo to. `up_caption`: The caption displayed when all checks are passing. `down_caption`: The caption displayed when all checks are failing. `mixed_caption`: The caption displayed when some checks are failing. `custom_css`: Custom CSS that will be injected into the status page.

Returns a 201 Created response containing the created status page's details.

Update a status page

bash

  

curl -u AUTH_TOKEN: -X POST -H 'Content-type: application/json' \
  -d '{
        "status_page": {
            "domain": "different.custom.domain",
            "sites": [
              {
                "site_id": "7d25f58b-d1a9-49f1-b10a-ac7ee44a6537",
                "display_name": "Main site"
              }
            ]
        }
    }' https://app.honeybadger.io/v2/accounts/ACCOUNT_ID/status_pages/ID

You can specify one or more of these fields within the status page object:

Field name	Type	Description
name	string	The name of the status page
domain	string	A custom domain for the status page. Changing this will trigger the domain DNS verification check.
sites	object[]	Details of sites to add to this status page. Each object references a site in a project in this account, and must contain the `site_id` and an optional `display_name`.
hide_branding	boolean	Whether or not to hide the Honeybadger branding in the footer of the status page. Only available on the Team plan and above.
features	object	Additional customization options only available on the Team plan and above. Available options: `home_link`: URL to hyperlink the status page title or logo to. `up_caption`: The caption displayed when all checks are passing. `down_caption`: The caption displayed when all checks are failing. `mixed_caption`: The caption displayed when some checks are failing. `custom_css`: Custom CSS that will be injected into the status page.

Returns an empty response (204 No Content) if successful.

Delete a status page

bash

curl -u AUTH_TOKEN: -X DELETE https://app.honeybadger.io/v2/accounts/ACCOUNT_ID/status_pages/ID

Returns an empty response (204 No Content) if successful.