v3

latestOpenAPI 3.1.0Proprietary2026-08-07266348629.6 KB
Agents

Get Agent Logs

Tailed [AGENT]-prefixed Flink TM logs + recent job exceptions.

The write:agents gate is intentional: agent log lines may contain customer payloads that flowed through prompts and tool args. Tightening the audit surface here mirrors how the Streamkap MCP project key blob is gated.

Per-line scoping is namespace-wide for now - when multiple agents share a TaskManager, lines from other agents may appear. Documented limitation until the Java runtime emits per-line agent IDs.

since is an optional ISO 8601 cutoff for incremental polling on the unified observability surface. The underlying tail window is Nx4 the requested tail count; if since is far enough back that the window doesn't reach it, the response is still bounded by tail (the caller can widen tail to compensate).

get/agents/{job_id}/logs

Path parameters

job_idstring required

Query parameters

tailinteger
levelstring
searchstring nullable
sincestring nullable

Response

Successful Response

scope'namespace' | 'agent'

Per-line scoping of returned lines. namespace means lines may include [AGENT] entries from other agents sharing a TaskManager (current limitation). agent will be returned once the Java runtime emits per-line agent IDs.