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.
REST-API
JSON über HTTPS für Skripte, CI/CD, Chatbots und eigene Dashboards. 102 Endpunkte, beschrieben als OpenAPI.
Terraform und OpenTofu
Services, Statuspages, Komponenten, Wartungen und eigene Domains als Code. Mit Plan, Review und Import bestehender Objekte.
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.
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 EndpunkteMonitore 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 EndpunkteVorfä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 EndpunkteWartungsfenster 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 EndpunkteStatuspages 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 EndpunkteBereitschaftsplä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 EndpunkteSchlü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 EndpunkteTags 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 EndpunkteDie 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
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-ProviderLeg los mit einem Token
Konto anlegen, Token erstellen, erster Aufruf. Die Doku führt dich in fünf Minuten durch.