---
title: "Private runtime trace objects [read, original owner only]"
method: GET
path: "/sessions/{id}/trace"
---

# Private runtime trace objects \[read, original owner only\]

`GET /sessions/{id}/trace`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/sessions/{id}/trace`
- Auth: HTTP bearer

Paginated original capture objects, including raw frames, native transcripts and model-call bodies. Retained operating evidence remains readable after soft deletion; this does not restore the Session. Requires session management authority and the caller to own both the Session and its Agent definition; a hire, shared transcript or pod credential is insufficient. Object URLs expire after 15 minutes and bind the listed generation. Never log or persist URLs. Capture may be partial or missing; this is operating evidence, not a training/export consent grant.

## Path parameters

- `id` string, required

## Query parameters

- `cursor` string

## Response `200`

Private trace page

- object
  - `sessionId` string, required
  - `cursor` string, nullable, required
  - `objects` object[], required
    - `path` string, required
    - `generation` string, required
    - `size` string, required
    - `crc32c` string, required
    - `md5` string
    - `url` string, uri, required

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/sessions/:id/trace/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)
