List app lifecycle events

GET/events

A batch of app lifecycle events (created / phase_changed / health_changed / domain / deleted) after the given cursor, plus the current max cursor. Poll with the returned cursor to follow. The stream is an in-memory ring; a reader offline longer than the ring loses old events (usage totals stay correct via GET /usage). 501 with no app manager.

query parameters

object

sinceintegermin 0

Resume after this cursor (seq); 0 returns the events still in the ring.

appstring

Filter to a single app by name; empty returns all apps.

Responses

200 OKOK

EventsResponse

cursorintegermin 0

eventsarray | null

items

AppEvent

appstring

app_idstring

attrsobject

additional properties

any

instancestring

reasonstring

seqintegermin 0

timestringdate-time

typestring

400 Bad requestBad Request

ErrorResponse

codestring

errorstring

501 Not Implemented

ErrorResponse

codestring

errorstring

Authentication

bearerAuthHTTP bearer. Daemon API key. Omit on a keyless loopback daemon.

Request

▍GET/events

cURL

curl '/events?since=&app='

JavaScript

const response = await fetch("/events?since=&app=", {
  method: "GET",
});
const data = await response.json();

Python

import requests

response = requests.get(
    "/events?since=&app=",
)
data = response.json()

Response

200 OK

{
  "cursor": 0,
  "events": [
    {
      "app": "string",
      "app_id": "string",
      "attrs": {},
      "instance": "string",
      "reason": "string",
      "seq": 0,
      "time": "2026-01-02T15:04:05Z",
      "type": "string"
    }
  ]
}