---
title: "List Agent Traces"
method: GET
path: "/internal/agent-traces"
---

# List Agent Traces

`GET /internal/agent-traces`

## Query parameters

- `limit` integer
- `since` string, nullable
- `until` string, nullable
- `from_routines` boolean
- `with_plans` boolean
- `with_plan_errors` boolean
- `workspace_id` integer, nullable
- `email` string, nullable
- `session_id` integer, nullable

## Headers

- `Authorization` string, nullable
- `X-Browser-Time-Zone` string, nullable

## Cookies

- `session_id` string, nullable

## Response `200`

Successful Response

- AgentTracesResponse
  - `project` string, required
  - `fetched_at` string, date-time, required
  - `total_runs` integer, required
  - `total_plans` integer, required
  - `total_plan_errors` integer, required
  - `users` AgentTraceUser[], required
    - `user_id` string, required
    - `user_email` string, nullable, required
    - `sessions` AgentTraceSession[], required
      - `thread_id` string, required
      - `session_id` integer, nullable
      - `workspace_id` string, nullable, required
      - `runs` AgentTraceRun[], required
        - `id` string, required
        - `name` string, required
        - `start_time` string, date-time, required
        - `end_time` string, date-time, nullable, required
        - `status` string, nullable, required
        - `error` string, nullable, required
        - `messages` AgentTraceMessage[], required
          - `role` string, required
          - `content` string, required
          - `blocks` AgentTraceContentBlock[]
            - `type` string, required
            - `text` string, nullable
            - `tool_name` string, nullable
            - `tool_input` unknown
            - `tool_use_id` string, nullable
            - `is_error` boolean
        - `last_user_message` string, nullable, required
        - `total_tokens` integer, nullable, required
        - `total_cost` number, nullable, required
        - `num_turns` integer, nullable, required
        - `permission_mode` string, nullable, required
        - `langsmith_url` string, required
        - `tool_error_count` integer
        - `comment_count` integer
      - `last_run_at` string, date-time, required
      - `last_user_message` string, nullable, required
      - `title` string, nullable, required
      - `run_count` integer, required
      - `error_count` integer, required
      - `comment_count` integer, required
      - `plan_count` integer, required
      - `plan_error_count` integer, required
      - `from_routine` boolean, required
    - `session_count` integer, required
    - `run_count` integer, required
    - `error_count` integer, required
    - `total_tokens` integer, required
    - `total_cost` number, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/runconverge/apis/fastapi.md) · [All operations](https://skmtc.dev/runconverge/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runconverge/fastapi/revisions/1452e350bd1d/schema)