Sign in
trace_destinations

Create trace destination

Send this organization's agent traces to an OpenTelemetry backend it owns.

Every finished agentic search, chat completion, and question-answering run is converted to OTLP spans and pushed to the destination: the agent's query, the tool calls it made with their arguments and results, the model turns with their token usage, and the chunks it returned, which is the same trace the dashboard shows. Mixedbread's own internal spans are never exported.

langfuse destinations take the host and the project key pair; otlp takes a traces endpoint and its auth headers, which covers any OTLP/HTTP collector. The credentials are checked against the destination before it is stored.

post/v1/trace-destinations

Request body

namestring required

Human-readable name

provider'langfuse' | 'otlp'

Destination type

hoststring nullable

Langfuse base URL, e.g. https://cloud.langfuse.com

public_keystring nullable

Langfuse project public key

secret_keystring nullable

Langfuse project secret key

endpointstring nullable

OTLP/HTTP traces endpoint, for the otlp provider

headersobject nullable

Headers sent with every OTLP request, for the otlp provider

event_typesstring[]

Which trace kinds to export

enabledboolean

Whether to start exporting immediately

Example request

{
  "host": "https://cloud.langfuse.com"
}

Response

The connected trace destination

idstring uuid required

Unique identifier of the destination

namestring required

Human-readable name

provider'langfuse' | 'otlp' required

Destination type

endpointstring required

OTLP/HTTP traces endpoint spans are posted to

credential_hintstring nullable

Non-secret half of the credential: the Langfuse public key, or the auth header name

event_typesstring[] required

Which trace kinds are exported to this destination

enabledboolean required

Whether traces are currently being exported

last_exported_atstring date-time nullable

When a batch last reached the destination

last_errorstring nullable

Why the most recent delivery failed; cleared by the next success

last_error_atstring date-time nullable

When the most recent delivery failed

created_atstring date-time required

When the destination was created

updated_atstring date-time required

When the destination was last updated

object'trace_destination'

Type of the object

Changes

Changed in 2 of the 17 revisions of this API.12

  • d2ebbe3adcaa11See the full diff
    • ●

      added the new qa enum value to the / response property for the response status

      response-property-enum-value-added

    • ○

      added the new qa enum value to the request property /

      request-property-enum-value-added

  • 4ec9b6a07a951See the full diff
    • ○

      endpoint added

      endpoint-added