---
title: "PUT /api/v1/traces/{id}"
method: PUT
path: "/api/v1/traces/{id}"
tags: ["Traces"]
---

# PUT /api/v1/traces/{id}

`PUT /api/v1/traces/{id}`

Update individual trace

## Path parameters

- `id` string, uuid, required

## Request body

- TraceUpdateRequest
  - `score` number — Updated evaluator score between 0 and 1.
  - `feedback` string, nullable — Updated feedback text for this trace.
  - `projectId` string, uuid, nullable — Project to associate with the trace.

## Response `200`

success response

- Trace
  - `id` string, uuid, required — Unique trace identifier.
  - `createdAt` string, date-time, required — ISO timestamp representing when the trace was recorded.
  - `modelId` string, required — Model identifier attached to the trace.
  - `projectId` string, uuid, nullable, required — Project identifier, null when the trace is not linked to a project.
  - `input` string, required — Prompt or message provided to the model.
  - `output` string, required — Model response captured for the trace.
  - `score` number, nullable, required — Score between 0 and 1. Null when the trace has not been scored yet.
  - `feedback` string, nullable, required — Feedback provided for the trace.
  - `addedToDataset` boolean, required — Flag indicating whether the trace is already in the dataset.
  - `processingStatus` 'none' | 'processing' | 'failed', required — Background processing status used when generating improved datapoints.

## Other responses

- `400` — bad request
- `401` — unauthenticated
- `403` — unauthorized
- `404` — not found
- `409` — conflict
- `500` — internal server error

---

[API](https://skmtc.net/premai-io/apis/prem-studio-api.md) · [All operations](https://skmtc.net/premai-io/apis/prem-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/premai-io/prem-studio-api/revisions/2cb1f5df1b89/schema)