Live

Change hints for live tables (held read)

tenant-live-changes. Hints since cursor, or with wait (clamped 1..25 s) hold until the first hint arrives, woken by the notification path rather than by polling. resync: true (with tables) means the cursor could not be answered: refetch. The held read is not counted against the live connection cap. Also served on every tenant host at /_run402/live/changes.

get/live/v1/changes

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/live/v1/changes
  • Auth: API key in header apikey

Query parameters

project_idstring required
tablesstring required

Comma-separated live table names.

cursorstring

Cursor from a previous response or a change event id.

waitinteger

Hold up to this many seconds for the first hint. Clamped to 1..25; non-numeric is 400.

Response

Hints since the cursor.

cursorstring required

Continue from here.

resyncboolean required
tablesstring[]

Present when resync is true: the tables to refetch.

waited_secondsinteger

Changes

No recorded changes to this operation across all 1 revision of this API.