Zum Inhalt springen
LIVCK Cloud

LIVCK per Code steuern

Was du in der Konsole klickst, geht auch über die REST-API, mit Terraform und über deinen KI-Assistenten. 102 API-Endpunkte und 122 MCP-Werkzeuge, alle mit denselben Rechten wie in der Konsole.

Vier Wege zu deinen Daten

Nimm den Weg, der zu deiner Arbeit passt. Alle vier sprechen mit derselben Organisation und halten sich an dieselben Rollen und Rechte.

ab Team

REST-API

JSON über HTTPS für Skripte, CI/CD, Chatbots und eigene Dashboards. 102 Endpunkte, beschrieben als OpenAPI.

ab Team

Terraform und OpenTofu

Services, Statuspages, Komponenten, Wartungen und eigene Domains als Code. Mit Plan, Review und Import bestehender Objekte.

alle Pläne

MCP-Server für KI-Assistenten

Claude Code, Cursor, VS Code, Codex und viele andere Clients arbeiten direkt mit LIVCK. Alles mit Wirkung nach außen erst nach deiner Bestätigung.

ab Team

SDKs für PHP und Laravel

Fertige Clients statt rohem HTTP. Das Laravel-Paket bringt eine Facade, mehrere Verbindungen und ein Test-Fake für deine Tests mit.

Was kann die API?

Jeder Bereich in zwei Sätzen. Darunter steht die vollständige Liste der Endpunkte, direkt aus der API-Beschreibung erzeugt. Sie ist also immer auf dem Stand des Produkts.

Services

15 Endpunkte

Monitore anlegen, ändern, pausieren, fortsetzen und löschen. Dazu die letzten Checks, Uptime je Tag, Antwortzeiten und ein manueller Status, wenn du selbst etwas melden willst.

Endpunkte anzeigen
  • GET/services

    List services (paginated)

  • POST/services

    Create a service

  • DELETE/services/{service}

    Delete a service

  • GET/services/{service}

    Get a service

  • PUT/services/{service}

    Update a service

  • GET/services/{service}/checks

    List check results (cursor-paginated)

  • GET/services/{service}/incidents

    List a service's incidents (paginated)

  • GET/services/{service}/maintenances

    List a service's maintenances (paginated)

  • GET/services/{service}/metrics

    Aggregated stats for a range: uptime as a percentage (0-100), latency percentiles in ms, check counts

  • POST/services/{service}/pause

    Pause a service

  • GET/services/{service}/response-times

    Response-time trend (time-series) for a range

  • POST/services/{service}/resume

    Resume a paused service

  • DELETE/services/{service}/status-override

    Remove the manual status override

  • POST/services/{service}/status-override

    Apply a manual status override

  • GET/services/{service}/uptime

    Per-day uptime for the last N days (default 30, max 90). `uptime_percent` is 0-100

Vorfälle

7 Endpunkte

Vorfälle anlegen, Verlaufseinträge posten und auflösen. Texte gehen in jeder Sprache deiner Statuspages mit, auf Wunsch samt Benachrichtigung der Abonnenten.

Endpunkte anzeigen
  • GET/incidents

    List incidents (paginated)

  • POST/incidents

    Create an incident

  • DELETE/incidents/{incident}

    Delete an incident

  • GET/incidents/{incident}

    Get an incident (with its updates and affected services)

  • PUT/incidents/{incident}

    Update an incident

  • POST/incidents/{incident}/resolve

    Resolve an incident

  • POST/incidents/{incident}/updates

    Post an update to an incident

Wartungen

9 Endpunkte

Wartungsfenster planen, vorzeitig starten, verlängern, abschließen oder absagen. Während einer Wartung entstehen für die betroffenen Services keine Vorfälle.

Endpunkte anzeigen
  • GET/maintenances

    List scheduled maintenances (paginated)

  • POST/maintenances

    Schedule a maintenance

  • DELETE/maintenances/{maintenance}

    Delete a maintenance

  • GET/maintenances/{maintenance}

    Get a maintenance (with its updates and affected services)

  • PUT/maintenances/{maintenance}

    Update a maintenance

  • POST/maintenances/{maintenance}/cancel

    Cancel a scheduled maintenance

  • POST/maintenances/{maintenance}/complete

    Complete a running maintenance window

  • POST/maintenances/{maintenance}/extend

    Extend a running or already-completed maintenance window

  • POST/maintenances/{maintenance}/start

    Start a maintenance window now

Statuspages

30 Endpunkte

Statuspages anlegen, gestalten und veröffentlichen. Komponenten, Gruppen, Diagramme, Logo und eigene Domain samt Prüfung gehören dazu.

Endpunkte anzeigen
  • GET/statuspages

    List status pages (paginated)

  • POST/statuspages

    Create a status page

  • DELETE/statuspages/{statuspage}

    Delete a status page

  • GET/statuspages/{statuspage}

    Get a status page, including its component tree

  • PUT/statuspages/{statuspage}

    Update a status page

  • DELETE/statuspages/{statuspage}/assets/{asset}

    Remove a status page asset

  • POST/statuspages/{statuspage}/assets/{asset}

    Upload (replace) a status page asset

  • GET/statuspages/{statuspage}/components

    List a status page's components

  • POST/statuspages/{statuspage}/components

    Create a component

  • DELETE/statuspages/{statuspage}/components/{component}

    Delete a component

  • GET/statuspages/{statuspage}/components/{component}

    Get a component

  • PUT/statuspages/{statuspage}/components/{component}

    Update a component

  • GET/statuspages/{statuspage}/custom-domains

    List a status page's custom domains

  • POST/statuspages/{statuspage}/custom-domains

    Attach a custom domain

  • DELETE/statuspages/{statuspage}/custom-domains/{domain}

    Detach a custom domain

  • GET/statuspages/{statuspage}/custom-domains/{domain}

    Get a custom domain

  • POST/statuspages/{statuspage}/custom-domains/{domain}/verify

    Trigger an immediate verification re-check

  • GET/statuspages/{statuspage}/layout

    Get a status page's layout

  • PUT/statuspages/{statuspage}/layout

    Replace a status page's layout

  • GET/statuspages/{statuspage}/metrics

    List a status page's metric charts (with their series)

  • POST/statuspages/{statuspage}/metrics

    Create a metric chart

  • DELETE/statuspages/{statuspage}/metrics/{metric}

    Delete a metric chart and its series

  • GET/statuspages/{statuspage}/metrics/{metric}

    Get a metric chart

  • PUT/statuspages/{statuspage}/metrics/{metric}

    Update a metric chart

  • POST/statuspages/{statuspage}/metrics/{metric}/series

    Add a series to a metric chart

  • DELETE/statuspages/{statuspage}/metrics/{metric}/series/{series}

    Delete a series

  • GET/statuspages/{statuspage}/metrics/{metric}/series/{series}

    Get a series

  • PUT/statuspages/{statuspage}/metrics/{metric}/series/{series}

    Update a series

  • POST/statuspages/{statuspage}/publish

    Publish a status page

  • POST/statuspages/{statuspage}/unpublish

    Unpublish a status page (emergency takedown)

Rufbereitschaft

20 Endpunkte

Bereitschaftspläne, Schichten, Vertretungen und Abwesenheiten verwalten. Eine Abfrage beantwortet, wer gerade Bereitschaft hat.

Endpunkte anzeigen
  • GET/oncall/absences

    List the organization's absences

  • POST/oncall/absences

    Record an absence for a member

  • DELETE/oncall/absences/{absence}

    Delete an absence. Future shifts revert to the base rotation

  • DELETE/oncall/cover-requests/{coverRequest}

    Cancel an open cover request

  • POST/oncall/cover-requests/{coverRequest}/accept

    Accept a cover request

  • POST/oncall/cover-requests/{coverRequest}/decline

    Decline a cover request sent to you

  • GET/oncall/on-call

    Who is on call in a time window

  • GET/oncall/schedules

    List on-call schedules (paginated)

  • POST/oncall/schedules

    Create an on-call schedule

  • DELETE/oncall/schedules/{schedule}

    Delete an on-call schedule

  • GET/oncall/schedules/{schedule}

    Get an on-call schedule

  • PUT/oncall/schedules/{schedule}

    Update an on-call schedule (partial)

  • GET/oncall/schedules/{schedule}/cover-requests

    List a schedule's cover requests

  • POST/oncall/schedules/{schedule}/cover-requests

    Request cover for a shift

  • GET/oncall/schedules/{schedule}/on-call

    Who is on call now for one schedule

  • GET/oncall/schedules/{schedule}/overrides

    List a schedule's overrides

  • POST/oncall/schedules/{schedule}/overrides

    Create an override

  • DELETE/oncall/schedules/{schedule}/overrides/{override}

    Delete an override

  • POST/oncall/schedules/{schedule}/shifts

    Add a shift to a manual schedule

  • POST/oncall/schedules/{schedule}/shifts/preview

    Preview a schedule's rotation

Server-Agent

12 Endpunkte

Schlüssel zum Einbinden neuer Server erzeugen, aktuelle Werte und Verlauf eines Servers lesen, Ereignisse abrufen und Schwellwerte für Alarme setzen.

Endpunkte anzeigen
  • GET/enrollment-keys

    List enrollment keys (paginated), newest first

  • POST/enrollment-keys

    Create an enrollment key

  • DELETE/enrollment-keys/{key}

    Revoke an enrollment key

  • GET/enrollment-keys/{key}

    Get an enrollment key, with the servers enrolled with it

  • GET/services/{service}/agent-events

    List agent lifecycle events (paginated)

  • GET/services/{service}/agent-metrics

    Current figures of a server

  • GET/services/{service}/agent-metrics/history

    History of a server's figures

  • GET/services/{service}/conditions

    List a server's threshold conditions

  • POST/services/{service}/conditions

    Create a threshold condition

  • DELETE/services/{service}/conditions/{condition}

    Delete a threshold condition

  • GET/services/{service}/conditions/{condition}

    Get a threshold condition

  • PUT/services/{service}/conditions/{condition}

    Update a threshold condition

Tags

6 Endpunkte

Tags anlegen, umbenennen und einfärben. Ein Aufruf findet einen Tag oder legt ihn an, das macht Skripte wiederholbar.

Endpunkte anzeigen
  • GET/tags

    List tags (paginated)

  • POST/tags

    Create a tag

  • POST/tags/ensure

    Find or create a tag

  • DELETE/tags/{tag}

    Delete a tag

  • GET/tags/{tag}

    Get a tag

  • PUT/tags/{tag}

    Update a tag (rename and/or recolor)

Referenzdaten

3 Endpunkte

Die aktiven Monitoring-Standorte, alle Felder je Check-Typ und der aufrufende Token. Damit baust du gültige Anfragen, ohne zu raten.

Endpunkte anzeigen
  • GET/me

    Get the calling token

  • GET/meta/check-types

    Get the check-type configuration catalog

  • GET/probes

    List monitoring locations (probes)

Die Kurzbeschreibungen der Endpunkte stammen aus der englischen API-Referenz.

Ein Vorfall aus deinem Deployment

Dein Rollout geht schief und deine Pipeline weiß es zuerst. Ein Aufruf legt den Vorfall an, zeigt ihn auf der Statuspage und benachrichtigt die Abonnenten.

Das Wichtigste in Kürze

Basis-URL
https://api.livck.cloud/v1
Anmeldung
Bearer-Token im Header, Präfix lvk_
Ratenbegrenzung
120 Anfragen pro Minute je Token
Format
JSON, Listen paginiert, Fehler mit message und errors
Plan
API ab Team, MCP lesen in allen Plänen, schreiben ab Solo
POST /v1/incidents
curl -X POST https://api.livck.cloud/v1/incidents \
  -H "Authorization: Bearer $LIVCK_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": {
      "de": "Störung beim Bezahlvorgang",
      "en": "Payment issues at checkout"
    },
    "message": {
      "de": "Wir untersuchen das Problem.",
      "en": "We are investigating."
    },
    "severity": "major",
    "status": "investigating",
    "service_ids": ["V1StGXR8Z5jdHi6BmyTq2"],
    "is_published": true,
    "notify_subscribers": true
  }'

Schickst du is_published mit false, bleibt der Vorfall ein interner Entwurf. Veröffentlichen kannst du ihn später per PUT oder in der Konsole.

Ereignisse nach draußen

Nicht alles muss abgefragt werden. LIVCK meldet sich auch von selbst.

Signierte Webhooks

Jeder Webhook trägt eine Signatur nach dem Standard Webhooks. Jede Bibliothek für diesen Standard prüft sie, du musst nichts selbst bauen.

Feeds der Statuspage

Jede öffentliche Statuspage liefert ihren Verlauf als RSS und Atom und den aktuellen Zustand als status.json. Ohne Token, für Wikis, Dashboards und eigene Auswertungen.

Chat-Kanäle

Slack, Microsoft Teams, Discord und Telegram bekommen Alarme und Statusmeldungen direkt in den Kanal. Auf allen Plänen.

Wie sicher ist der Zugriff per Code?

Ein Token kann nie mehr als der Mensch, der ihn erstellt hat.

Tokens gehören der Organisation

API-Tokens sind Dienstkonten der Organisation. Sie hängen nicht an einer Person und überleben einen Wechsel im Team.

Nur die Rechte, die du hast

Beim Erstellen bekommt ein Token höchstens deine eigenen Rechte. Vergib nur, was das Skript wirklich braucht.

Eigener Token für KI-Assistenten

MCP-Tokens beginnen mit lvkm_ und funktionieren nur für den MCP-Server, nie für die normale API.

Erst Vorschau, dann Wirkung

Was Kunden erreicht, jemanden weckt, Alarme abschaltet oder löscht, zeigt der MCP-Server erst als Vorschau. Ausgeführt wird es nach deiner Bestätigung.

Häufige Fragen zur API

Die REST-API ist im Team-Tarif für 49 € und im Business-Tarif für 119 € netto im Monat enthalten. Ein eigenes API-Abo gibt es nicht. Pro Token sind 120 Anfragen pro Minute erlaubt. In Free und Solo gibt es keinen API-Zugang. Der MCP-Server liest dort trotzdem, ab Solo schreibt er auch.

Mit einem API-Token im Header Authorization: Bearer. Tokens beginnen mit lvk_ und gehören der Organisation, nicht einer Person. Du legst sie in der Konsole unter Einstellungen, API-Tokens an und gibst ihnen höchstens die Rechte, die du selbst hast.

Ja. Alle 102 Endpunkte sind als OpenAPI beschrieben, die Referenz liegt unter api.livck.cloud/docs/api. Die Liste der Endpunkte auf dieser Seite wird aus derselben Beschreibung erzeugt und ist deshalb immer auf dem Stand des Produkts.

Ja. Webhooks deiner Organisation tragen eine Signatur nach dem Standard Webhooks und lassen sich mit jeder passenden Bibliothek prüfen. Jede öffentliche Statuspage liefert außerdem status.json sowie RSS- und Atom-Feeds ohne Token. Slack, Microsoft Teams, Discord und Telegram bekommen Alarme direkt in den Kanal.

Ja, für PHP und Laravel. Das PHP-SDK heißt livck/cloud-php, das Laravel-Paket livck/cloud-laravel. Das Laravel-Paket bringt eine Facade, mehrere Verbindungen und ein Test-Fake mit. Für Infrastruktur als Code gibt es den Terraform-Provider.

Zum Terraform-Provider

Leg los mit einem Token

Konto anlegen, Token erstellen, erster Aufruf. Die Doku führt dich in fünf Minuten durch.