---
title: "Create component"
method: POST
path: "/api/status-page/{statusPageId}/component/create"
tags: ["Status Page Components"]
---

# Create component

`POST /api/status-page/{statusPageId}/component/create`

## Request

- Base URL: `https://api.spike.sh`
- URL: `https://api.spike.sh/api/status-page/{statusPageId}/component/create`
- Auth: none declared. Required headers: `x-api-key`
- TypeScript: <https://skmtc.dev/spike/apis/spike-sh-api/docs/api/status-page/:statusPageId/component/create/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new component for a status page

## Path parameters

- `statusPageId` string, required

## Headers

- `x-api-key` string, required

## Request body

- object
  - `components` object[], required
    - `name` string, required: Component name
    - `desc` string, required: Component description
    - `status` 'operational' | 'degraded-performance' | 'partial-outage' | 'critical-outage': Component status
    - `private` boolean: Component visibility

## Response `200`

Component created successfully

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/spike/apis/spike-sh-api.md) - [All operations](https://skmtc.dev/spike/apis/spike-sh-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spike/apis/spike-sh-api/revisions/6854629119aa?raw)