---
title: "Get session agent traces"
method: GET
path: "/v1/sessions/{id}/agent-traces"
tags: ["Sessions"]
---

# Get session agent traces

`GET /v1/sessions/{id}/agent-traces`

Query the semantic agent trace timeline for a session: a coalesced, replay-oriented record of user/agent interactions (clicks, typing, scrolls, drags, navigations) with target metadata (role, accessible name, selectors). Returns an empty list for sessions that predate browser-interaction capture.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `namespace` string
- `startTime` string, date-time
- `endTime` string, date-time
- `eventTypes` string[]

## Response `200`

Default Response

- GetSessionAgentTracesResponse
  - `events` object[], required
  - `hasMore` boolean, required
  - `total` number, required

## Other responses

- `400` — An error response from the API
- `404` — An error response from the API
- `500` — An error response from the API
- `502` — An error response from the API

---

[API](https://skmtc.net/steel-dev/apis/steel-api.md) · [All operations](https://skmtc.net/steel-dev/apis/steel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/steel-dev/steel-api/revisions/2248d956188a/schema)