---
title: "Update trace destination"
method: PATCH
path: "/v1/trace-destinations/{destination_id}"
tags: ["trace_destinations"]
---

# Update trace destination

`PATCH /v1/trace-destinations/{destination_id}`

Change a destination. Credentials are write-only: supply them to rotate, omit them to keep.

## Path parameters

- `destination_id` string, uuid, required — The ID of the trace destination

## Request body

- TraceDestinationUpdateParams — Fields to change on a destination; omitted fields keep their stored value. Credentials are write-only: supplying `secret_key` (or `headers`) replaces the stored header map, and omitting them leaves it untouched.
  - `name` string, nullable — Human-readable name
  - `host` string, nullable — Langfuse base URL
  - `public_key` string, nullable — Langfuse project public key
  - `secret_key` string, nullable — Langfuse project secret key
  - `endpoint` string, nullable — OTLP/HTTP traces endpoint
  - `headers` object, nullable — Headers sent with every OTLP request
  - `event_types` string[], nullable — Which trace kinds to export
  - `enabled` boolean, nullable — Whether traces are exported

## Response `200`

The updated trace destination

- TraceDestination — An OTLP endpoint this organization's agent traces are exported to.
  - `id` string, uuid, required — Unique identifier of the destination
  - `name` string, required — Human-readable name
  - `provider` 'langfuse' | 'otlp', required — Destination type
  - `endpoint` string, required — OTLP/HTTP traces endpoint spans are posted to
  - `credential_hint` string, nullable — Non-secret half of the credential: the Langfuse public key, or the auth header name
  - `event_types` string[], required — Which trace kinds are exported to this destination
  - `enabled` boolean, required — Whether traces are currently being exported
  - `last_exported_at` string, date-time, nullable — When a batch last reached the destination
  - `last_error` string, nullable — Why the most recent delivery failed; cleared by the next success
  - `last_error_at` string, date-time, nullable — When the most recent delivery failed
  - `created_at` string, date-time, required — When the destination was created
  - `updated_at` string, date-time, required — When the destination was last updated
  - `object` 'trace_destination' — Type of the object

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-27** `d2ebbe3adcaa` — 1 warning, 1 info
  - added the new `qa` enum value to the `event_types/items/` response property for the response status `200`
  - added the new `qa` enum value to the request property `event_types/anyOf[subschema #1]/items/`
- **2026-08-26** `4ec9b6a07a95` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/trace-destinations/:destination_id/patch.md)

---

[API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/revisions/eb12b76f5763/schema)