---
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

## Changes

- **2026-06-07** `4985d7bcd32f` — 4 info
  - added the non-success response with the status `502`
  - added the optional property `linkToDocs` to the response with the `400` status
  - added the optional property `linkToDocs` to the response with the `404` status
  - added the optional property `linkToDocs` to the response with the `500` status
- **2026-05-22** `39bc3eb693fb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/steel-dev/apis/steel-api/changes/v1/sessions/:id/agent-traces/get.md)

---

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