Deutsch English

Komponente anlegen

POST /api/v1/components

Der Slug wird aus dem Namen abgeleitet und nicht vom Client entgegengenommen.

Erforderliche Berechtigung

components.manage Komponenten verwalten

Body Parameter (application/json)

Name Format Beschreibung Optional
name Mehrsprachiger Text als Objekt je Sprache, z. B. {"de": "…", "en": "…"}. Ein einfacher String wird in der Hauptsprache der Statusseite gespeichert. Bei PATCH partiell: eine weggelassene Sprache bleibt unverändert, ein ausdrückliches null löscht sie. —
description Mehrsprachiger Text als Objekt je Sprache, z. B. {"de": "…", "en": "…"}. Ein einfacher String wird in der Hauptsprache der Statusseite gespeichert. Bei PATCH partiell: eine weggelassene Sprache bleibt unverändert, ein ausdrückliches null löscht sie.
group_id Integer
is_public Boolean
subscribable Boolean
position Integer
webhook_enabled Boolean
host_system_id Integer

Beispiel-Request (application/json) 

{
  "name": {
    "de": "API-Gateway",
    "en": "API gateway"
  },
  "description": {
    "de": "Die öffentliche Schnittstelle",
    "en": "The public interface"
  },
  "group_id": 1,
  "is_public": true,
  "subscribable": true,
  "position": 0,
  "webhook_enabled": true,
  "host_system_id": 0
}

Werte sind Beispiele — Pflichtfelder stehen in der Tabelle. Der Body wird als JSON gesendet.

Response (application/json) 

{1 Eigenschaft
  "data": {13 Eigenschaften
    "id": 14,
    "name": {2 Eigenschaften
      "de": "API-Gateway",
      "en": "API gateway"
    },
    "description": {2 Eigenschaften
      "de": "Die öffentliche Schnittstelle",
      "en": null
    },
    "slug": "api-gateway",
    "group_id": 1,
    "position": 0,
    "is_public": true,
    "subscribable": true,
    "status": "operational",
    "uptime_90d": 1,
    "remote_trigger": {5 Eigenschaften
      "webhook_enabled": false,
      "webhook_url": null,
      "webhook_status": null,
      "webhook_status_at": null,
      "host_system": null
    },
    "created_at": "2026-07-27T14:00:00Z",
    "updated_at": "2026-07-27T14:00:00Z"
  }
}
{2 Eigenschaften
  "message": "This API accepts JSON only. Send the request body as application/json (received application/x-www-form-urlencoded).",
  "documentation_url": "https://docs.firestatus.de"
}
{3 Eigenschaften
  "message": "The name field must be filled in at least one language (de, en).",
  "errors": {1 Eigenschaft
    "name": [1 Element
      "The name field must be filled in at least one language (de, en)."
    ]
  },
  "documentation_url": "https://docs.firestatus.de"
}

cURL

curl -X POST 'https://status.example.com/api/v1/components' \
  -H 'Authorization: Bearer fs_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":{"de":"API-Gateway","en":"API gateway"},"description":{"de":"Die öffentliche Schnittstelle","en":"The public interface"},"group_id":1,"is_public":true,"subscribable":true,"position":0,"webhook_enabled":true,"host_system_id":0}'