Create Status Page

curl -X POST "https://kodostatus.com/api/v1/status-pages" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Partner Dashboard",
    "slug": "acme-partners",
    "status_page_visibility": "private",
    "primary_color": "#6366f1",
    "tagline": "Real-time system health",
    "theme_mode": "dark",
    "font_family": "dm-sans",
    "service_ids": ["svc_abc123", "svc_def456"]
  }'

const response = await fetch('https://kodostatus.com/api/v1/status-pages', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.KODO_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Partner Dashboard',
    slug: 'acme-partners',
    status_page_visibility: 'private',
    primary_color: '#6366f1',
    tagline: 'Real-time system health',
    theme_mode: 'dark',
    font_family: 'dm-sans',
    service_ids: ['svc_abc123', 'svc_def456']
  })
});

{
  "page": {
    "id": "uuid",
    "name": "Partner Dashboard",
    "slug": "acme-partners",
    "status_page_visibility": "private",
    "is_default": false,
    "primary_color": "#6366f1",
    "tagline": "Real-time system health",
    "theme_mode": "dark",
    "font_family": "dm-sans",
    "created_at": "2024-06-15T12:00:00Z",
    "updated_at": "2024-06-15T12:00:00Z"
  }
}

POST

status-pages

curl -X POST "https://kodostatus.com/api/v1/status-pages" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Partner Dashboard",
    "slug": "acme-partners",
    "status_page_visibility": "private",
    "primary_color": "#6366f1",
    "tagline": "Real-time system health",
    "theme_mode": "dark",
    "font_family": "dm-sans",
    "service_ids": ["svc_abc123", "svc_def456"]
  }'

const response = await fetch('https://kodostatus.com/api/v1/status-pages', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.KODO_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Partner Dashboard',
    slug: 'acme-partners',
    status_page_visibility: 'private',
    primary_color: '#6366f1',
    tagline: 'Real-time system health',
    theme_mode: 'dark',
    font_family: 'dm-sans',
    service_ids: ['svc_abc123', 'svc_def456']
  })
});

{
  "page": {
    "id": "uuid",
    "name": "Partner Dashboard",
    "slug": "acme-partners",
    "status_page_visibility": "private",
    "is_default": false,
    "primary_color": "#6366f1",
    "tagline": "Real-time system health",
    "theme_mode": "dark",
    "font_family": "dm-sans",
    "created_at": "2024-06-15T12:00:00Z",
    "updated_at": "2024-06-15T12:00:00Z"
  }
}

Creating status pages is subject to your plan’s page limit. Starter is limited to 1 page, Pro to 2, Team to 3, and Enterprise is unlimited.

Body Parameters

Required

string

required

Display name for the status page

string

required

URL slug (must be unique across all organizations). Used in /status/{slug}

The slug must contain only lowercase letters, numbers, and hyphens. For example: my-company, acme-status, api2.

Optional

string

default:"public"

Visibility mode: public, private, internal. Availability depends on plan.

string[]

Array of service IDs to assign to this page. Services will be displayed in the order provided.

string

Brand color in #RRGGBB hex format. Example: "#22c55e"

string

Secondary brand color in #RRGGBB hex format. Example: "#3b82f6"

string

Short tagline displayed below the page name.

string

URL to a logo image displayed in the page header.

string

URL to a favicon image for the status page.

string

default:"dark"

Color scheme: light, dark, or system.

string

default:"default"

Pre-built theme: default, minimal, corporate, neon, ocean, sunset.

string

default:"inter"

Font family: inter, dm-sans, space-grotesk, jetbrains-mono, poppins, merriweather, system.

string

default:"centered"

Header layout: centered or left-aligned.

string

default:"rounded"

Border radius preset: rounded, sharp, pill.

Whether to show the email subscribe form on the public page.

boolean

default:true

Whether to show the incident history timeline.

boolean

default:true

Whether to show uptime percentage graphs per service.

string

Banner announcement text displayed at the top of the page.

string

Announcement style: info, warning, critical, maintenance.

boolean

default:false

Whether the announcement banner is visible.

Response

Returns the created status page object with a 201 status code.

Common Errors

Status	Message	Description
400	`Slug must contain only lowercase letters, numbers, and hyphens`	Invalid slug format
400	`Invalid primary_color format (use #RRGGBB)`	Color must be a 6-digit hex code
400	`Invalid font_family`	Font ID not in the allowed list
403	`Plan limit reached`	Your plan’s status page limit has been reached
409	`This slug is already taken`	Another status page already uses this slug

curl -X POST "https://kodostatus.com/api/v1/status-pages" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Partner Dashboard",
    "slug": "acme-partners",
    "status_page_visibility": "private",
    "primary_color": "#6366f1",
    "tagline": "Real-time system health",
    "theme_mode": "dark",
    "font_family": "dm-sans",
    "service_ids": ["svc_abc123", "svc_def456"]
  }'

const response = await fetch('https://kodostatus.com/api/v1/status-pages', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.KODO_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Partner Dashboard',
    slug: 'acme-partners',
    status_page_visibility: 'private',
    primary_color: '#6366f1',
    tagline: 'Real-time system health',
    theme_mode: 'dark',
    font_family: 'dm-sans',
    service_ids: ['svc_abc123', 'svc_def456']
  })
});

{
  "page": {
    "id": "uuid",
    "name": "Partner Dashboard",
    "slug": "acme-partners",
    "status_page_visibility": "private",
    "is_default": false,
    "primary_color": "#6366f1",
    "tagline": "Real-time system health",
    "theme_mode": "dark",
    "font_family": "dm-sans",
    "created_at": "2024-06-15T12:00:00Z",
    "updated_at": "2024-06-15T12:00:00Z"
  }
}

List Status Pages Get Status Page

Overview

Status Pages

Status Page Design

Incidents

Services

Uptime Monitors

SSL Monitors

Domain Monitors

Heartbeat

Metrics

Notification Channels

Webhooks

Error Tracking

Releases

Source Maps

Maintenance

Configuration

Workflows

API Keys

Audit Log

Beacon

Create Status Page

Body Parameters

Required

Optional

Response

Common Errors

​Body Parameters

​Required

​Optional

​Response

​Common Errors

Body Parameters

Required

Optional

Response

Common Errors