Get Agent Logs

Recent agent log lines from the Flink task managers, plus recent job exceptions.

Requires write:agents because agent log lines may contain customer payloads that flowed through prompts and tool arguments.

Lines are scoped to the agent’s namespace: when several agents share a task manager, lines from other agents may appear.

tail (1-500, default 100) caps the number of lines; level filters by log level. 400 for an out-of-range tail or an unknown level. since is an optional ISO 8601 cutoff for incremental polling. The response is always bounded by tail, so if since is far back, widen tail to reach it.

GET/agents/{job_id}/logs

Authorization

AuthorizationBearer token · headerrequired

Path parameters

job_idstringrequired

Query parameters

tailinteger

default: 100

levelstring

default: "INFO"

searchstring

sincestring

Responses

200

Successful Response

linesAgentLogLine[]

Show properties

Array of AgentLogLine

timestampstring | null

Line timestamp as emitted by the Flink logger

Show properties

Any of:

string

string

null

null

levelstring

Log level — DEBUG, INFO, WARN, ERROR

default: "INFO"

messagestringrequired

Log message body

flinkExceptionsAgentFlinkException[]

Show properties

Array of AgentFlinkException

timestampstring | null

ISO8601 timestamp (Flink millis-since-epoch normalised)

Show properties

Any of:

string

string

null

null

exceptionstringrequired

Stack trace or exception text

taskstring | null

Flink task name when available

Show properties

Any of:

string

string

null

null

scopestring

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 agent runtime emits per-line agent IDs.

default: "namespace"

Allowed:namespaceagent

422

Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X GET 'https://api.streamkap.com/agents/string/logs' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://api.streamkap.com/agents/string/logs", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.streamkap.com/agents/string/logs",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

Response

{
  "lines": [
    {
      "timestamp": "string",
      "level": "INFO",
      "message": "string"
    }
  ],
  "flinkExceptions": [
    {
      "timestamp": "string",
      "exception": "string",
      "task": "string"
    }
  ],
  "scope": "namespace"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}