---
title: "List the workspace's trace library [read]"
method: GET
path: "/trace-library"
tags: ["trace-library"]
---

# List the workspace's trace library \[read\]

`GET /trace-library`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/trace-library`
- Auth: HTTP bearer

Every uploaded local session in the current workspace, most recently updated first. Workspace keys are refused: uploads and reads belong to a person. Returns 503 not_migrated before the tables exist.

## Query parameters

- `limit` integer
- `cursor` string
- `uploader` string
- `harness` string
- `project` string

## Response `200`

OK

- object
  - `traces` LibraryTrace[], required
    - `id` string, required: ltr_…
    - `harness` string, required
    - `session_id` string, required
    - `title` string, nullable
    - `project` string, nullable: The repository's folder name
    - `cwd` string, nullable: Where the session ran, home written as ~
    - `git_branch` string, nullable
    - `git_commit` string, nullable
    - `git_remote` string, nullable: The repository URL, without credentials
    - `model` string, nullable: The model that answered most
    - `models` string[]: Every model that answered, most-used first; empty when the upload named none
    - `harness_version` string, nullable
    - `client` string, nullable: The front end that ran the harness, such as a Claude Code entrypoint or a Codex originator
    - `model_provider` string, nullable
    - `effort` string, nullable
    - `usage` object, nullable: Token totals the source reported, by kind
      - `input_tokens` integer
      - `output_tokens` integer
      - `cache_read_tokens` integer
      - `cache_write_tokens` integer
      - `reasoning_tokens` integer
    - `uploader_id` string, required
    - `device` string, nullable
    - `started_at` string, date-time, nullable
    - `ended_at` string, date-time, nullable
    - `user_turns` integer
    - `tool_calls` integer
    - `messages` integer, required: Stored messages, after redaction
    - `coverage` 'complete' | 'partial' | 'redacted', required
    - `version` integer, required: Raised each time a changed upload replaces it
    - `updated_at` string, date-time, required
    - `environment` object, nullable: The working folder the session ran in, uploaded with it as one of the uploader's files
      - `file_id` string
      - `name` string
      - `bytes` integer
      - `files` integer
      - `sha256` string
  - `next_cursor` string, nullable, required
  - `total` integer, required

## Other responses

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

## Changes

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

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/trace-library/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/0d435187cd55?raw)