Status Pages

Create a status page

Create a public or private status page.

POSThttps://api.vantaj.co/v1/status-pages

Requires an API key with the status_pages:write scope.

Authorizations

Authorizationstringheaderrequired

Bearer authentication using your API key: Authorization: Bearer <token>

Body

application/json

project_idstring<uuid>required

Project the status page belongs to.

namestringrequired

Display name (1–200 characters).

slugstring | null

Public URL slug (lowercase letters, numbers, hyphens).

is_publicboolean

Whether the page is publicly accessible.

Default:false

descriptionstring | null

Short description shown on the page.

accent_colorstring

Hex accent color, e.g. #2563eb.

Default:#2563eb

show_powered_byboolean

Show the "Powered by Vantaj" footer.

Default:true

show_historyboolean

Show incident history.

Default:true

history_daysinteger

Days of history to display (1–365).

Default:90

rss_enabledboolean

Expose an incident RSS feed.

Default:false

subscribe_enabledboolean

Allow email subscriptions.

Default:false

custom_domainstring | null

Custom domain for the page.

sectionsobject[]

Groups of monitors: { id, title, monitor_ids }.

Create a status page

cURL

curl --request POST \
  --url 'https://api.vantaj.co/v1/status-pages' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "project_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "name": "Acme Status",
  "slug": "acme",
  "is_public": true
}'

{
  "data": {
    "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
    "name": "Acme Status",
    "slug": "acme",
    "is_public": true,
    "description": "Live status of Acme services.",
    "accent_color": "#2563eb",
    "show_powered_by": true,
    "show_history": true,
    "history_days": 90,
    "rss_enabled": false,
    "subscribe_enabled": true,
    "custom_domain": "status.acme.com",
    "sections": [
      {
        "id": "sec_1",
        "title": "Core",
        "monitor_ids": [
          "d290f1ee-6c54-4b01-90e6-d701748f0851"
        ]
      }
    ],
    "project_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-06-01T08:00:00Z"
  }
}