---
title: "ReportAgentTrace"
method: POST
path: "/gitpod.v1.InsightsService/ReportAgentTrace"
tags: ["gitpod.v1.InsightsService"]
---

# ReportAgentTrace

`POST /gitpod.v1.InsightsService/ReportAgentTrace`

Reports an agent trace session for a project environment.
 Stores the raw trace alongside denormalized line-change totals.

## Request body

- GitpodV1ReportAgentTraceRequest — ReportAgentTraceRequest pushes an agent trace session containing one or more trace lines (typically JSONL) for storage.
  - `agentExecutionId` string, uuid — Agent execution that produced the trace.
  - `environmentId` string, uuid — Environment that produced the trace.
  - `linesAdded` string — Total lines added across all edits in the trace session.
  - `linesRemoved` string — Total lines removed across all edits in the trace session.
  - `model` 'SUPPORTED_MODEL_UNSPECIFIED' | 'SUPPORTED_MODEL_SONNET_3_5' | 'SUPPORTED_MODEL_SONNET_3_7' | 'SUPPORTED_MODEL_SONNET_3_7_EXTENDED' | 'SUPPORTED_MODEL_SONNET_4' | 'SUPPORTED_MODEL_SONNET_4_EXTENDED' | 'SUPPORTED_MODEL_SONNET_4_5' | 'SUPPORTED_MODEL_SONNET_4_5_EXTENDED' | 'SUPPORTED_MODEL_SONNET_4_6' | 'SUPPORTED_MODEL_SONNET_4_6_EXTENDED' | 'SUPPORTED_MODEL_SONNET_5' | 'SUPPORTED_MODEL_OPUS_4' | 'SUPPORTED_MODEL_OPUS_4_EXTENDED' | 'SUPPORTED_MODEL_OPUS_4_5' | 'SUPPORTED_MODEL_OPUS_4_5_EXTENDED' | 'SUPPORTED_MODEL_OPUS_4_6' | 'SUPPORTED_MODEL_OPUS_4_6_EXTENDED' | 'SUPPORTED_MODEL_OPUS_4_7' | 'SUPPORTED_MODEL_OPUS_4_8' | 'SUPPORTED_MODEL_HAIKU_4_5' | 'SUPPORTED_MODEL_OPENAI_4O' | 'SUPPORTED_MODEL_OPENAI_4O_MINI' | 'SUPPORTED_MODEL_OPENAI_O1' | 'SUPPORTED_MODEL_OPENAI_O1_MINI' | 'SUPPORTED_MODEL_OPENAI_AUTO' — SupportedModel enumerates the LLM models available for agent executions
  - `projectId` string, uuid — Project the trace belongs to.
  - `traces` string[] — Individual trace lines (typically one JSON object per line). May be empty when only line-count aggregates are reported. Each line is capped at 5 MiB.

## Response `200`

Success

- GitpodV1ReportAgentTraceResponse

## Other responses

- `default` — Error

## Changes

- **2026-07-30** `44d50c2ac284` — 4 info
  - added the new `SUPPORTED_MODEL_OPENAI_AUTO` enum value to the request property `model`
  - added the new `SUPPORTED_MODEL_OPUS_4_7` enum value to the request property `model`
  - added the new `SUPPORTED_MODEL_OPUS_4_8` enum value to the request property `model`
  - added the new `SUPPORTED_MODEL_SONNET_5` enum value to the request property `model`
- **2026-04-02** `dabc0ff98cd7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gitpod-io/apis/gitpod-v1/changes/gitpod.v1.InsightsService/ReportAgentTrace/post.md)

---

[API](https://skmtc.dev/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.dev/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/44d50c2ac284/schema)