v2

latestOpenAPI 3.1.0raw.githubusercontent.com2026-02-1251112.9 KB

Scan entries

Scan log entries for a given key within an optional sequence range.

Supports long-polling: set follow=true to hold the connection open until new data arrives or timeout_ms elapses (default 30 000 ms). This is useful for tailing a log stream in near-real-time.

get/api/v1/log/scan

Query parameters

keystring required

Key to scan (URL-encoded if it contains special characters).

start_seqinteger

Start sequence number (inclusive). Defaults to 0.

end_seqinteger

End sequence number (exclusive). Defaults to max uint64.

limitinteger

Maximum number of entries to return.

followboolean

If true, long-poll until data is available or timeout.

timeout_msinteger

Timeout in milliseconds for long-polling. Default 30000.

Response

Scan results.

statusstring required
keystring byte

The key that was scanned, base64-encoded.

Example response

{
  "status": "success"
}