Skip to main content
GET
List traces

Authorizations

Authorization
string
header
required

API key with the vk_ prefix. Create one from the dashboard.

Query Parameters

from
string<date-time>

Window start (RFC 3339). Default: to minus 24 hours.

to
string<date-time>

Window end (RFC 3339). Default: now. At most 30 days after from.

deployment_id
string
agent
string

Only this agent (its key).

kind
string

call | thread | session

errors_only
boolean

Only traces with errors.

active
boolean

Only threads and sessions live now. Single calls are never active.

q
string

Case-insensitive substring of a request id (a thread or session matches on any of its calls in the window), thread id, session id, title or preview.

tool
string

Only traces that used this tool in the window (a call or thread request carrying its result, a session's agent.tool_use). Exact name, as the overview's top_tools lists it.

model
string

Only traces with a model call on this model in the window (a request's adapter alias or deployment model, a session's model). Exact name, as the overview's top_models lists it.

session_id
string

One managed session: its row, and one call row per model call it made in the window. With kind=call, only those calls. On an id that is not a session of this workspace, an empty list.

limit
integer<int64>

Page size, 1..=500 (default 50).

after
string

next_cursor of the previous page. It pins the window end to of the page it came from, so omit to (or repeat the same value) on the following pages; another to is a 400.

Response

object
string
required

Always "list".

total
integer<int64>
required

Traces matching the filters across all pages.

counts
object
required

What the whole filtered list holds, across all pages.

has_more
boolean
required
data
object[]
required
next_cursor
string | null

Pass as after for the next page; null on the last page.