---
title: "Clickhouse Traces Update"
method: PUT
path: "/clickhouse/traces/"
tags: ["logs"]
---

# Clickhouse Traces Update

`PUT /clickhouse/traces/`

PUT handler with superadmin lock and field protection.

Same as patch() - checks lock and field protection before delegating.

## Headers

- `Authorization` string, required

## Request body

- CHTraceListRequest — Serializer for trace list data from the CTE query. Handles the output from _get_trace_queryset_with_cte. Inherits all common fields from BaseTraceSerializer and adds: - organization_name, organization_key_id: Organization details - metadata: Trace metadata - trace_group_identifier: For grouping related traces - model: Model information
  - `id` string, required
  - `trace_unique_id` string, required
  - `root_span_unique_id` string
  - `unique_organization_id` string
  - `environment` string
  - `customer_identifier` string
  - `start_time` string, date-time
  - `end_time` string, date-time
  - `duration` number, double
  - `span_count` integer
  - `llm_call_count` integer
  - `total_cost` number, double
  - `total_prompt_tokens` integer
  - `total_completion_tokens` integer
  - `total_tokens` integer
  - `error_count` integer
  - `name` string
  - `input` string
  - `output` string
  - `storage_object_key` string
  - `organization_name` string
  - `organization_id` string
  - `organization_key_id` string
  - `metadata` unknown
  - `trace_group_identifier` string
  - `session_identifier` string
  - `model` string

## Response `200`

- CHTraceList — Serializer for trace list data from the CTE query. Handles the output from _get_trace_queryset_with_cte. Inherits all common fields from BaseTraceSerializer and adds: - organization_name, organization_key_id: Organization details - metadata: Trace metadata - trace_group_identifier: For grouping related traces - model: Model information
  - `id` string, required
  - `trace_unique_id` string, required
  - `root_span_unique_id` string
  - `unique_organization_id` string
  - `environment` string
  - `customer_identifier` string
  - `start_time` string, date-time
  - `end_time` string, date-time
  - `duration` number, double
  - `span_count` integer
  - `llm_call_count` integer
  - `total_cost` number, double
  - `total_prompt_tokens` integer
  - `total_completion_tokens` integer
  - `total_tokens` integer
  - `error_count` integer
  - `name` string
  - `input` string
  - `output` string
  - `storage_object_key` string
  - `organization_name` string
  - `organization_id` string
  - `organization_key_id` string
  - `metadata` unknown
  - `trace_group_identifier` string
  - `session_identifier` string
  - `model` string

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)