---
title: "POST /api/v1/traces"
method: POST
path: "/api/v1/traces"
tags: ["Traces"]
---

# POST /api/v1/traces

`POST /api/v1/traces`

Create a trace with feedback

## Request body

- TraceCreateRequest
  - `input` string, required
  - `output` string, required
  - `modelId` string, required
  - `projectId` string, uuid, nullable
  - `score` number, nullable
  - `feedback` string, nullable
  - `conversationId` string, nullable

## Response `200`

success response

- Trace
  - `id` string, uuid, required
  - `input` string, required
  - `output` string, required
  - `modelId` string, required
  - `projectId` string, uuid, nullable
  - `score` number, nullable
  - `feedback` string, nullable
  - `conversationId` string, nullable

## Other responses

- `400` — bad request
- `401` — unauthenticated
- `403` — unauthorized
- `404` — not found
- `409` — conflict

## Changes

- **2025-09-04** `6fce808cc14e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/premai-io/apis/prem-studio-api/changes/api/v1/traces/post.md)

---

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