Skip to content
Documentation
GuidesAPI ReferenceIntegrations
ArenaPlatform
API Reference/Trace Export

List Trace Destinations

GET/v1/traces/destinations

Overview

Requires a dashboard session with read access to the workspace; API keys are rejected. Credentials are never returned: only header names and the last characters of a signing secret or Langfuse public key.

Authorization

Authorizationstring · headerRequired

Workspace session token sent as Bearer <token>. Authentication guide

Parameters

workspace_idquery · stringRequired

The destination's workspace; the session must be a member.

Responses

200Trace destinations, oldest first.
application/json
dataobject[]Required
Show nested fields
idstringRequired

trd_ followed by 22 characters.

Example: "trd_example"

objectstringRequired

Values: "trace_destination"

workspace_idstringRequired

Example: "ws_example"

namestringRequired

Example: "Honeycomb"

kindstringRequired

webhook: signed JSON. otlp: OTLP/HTTP traces. langfuse: Langfuse's ingestion API.

Values: "webhook""otlp""langfuse"

Example: "otlp"

endpointstringRequired

The URL traces are sent to; for Langfuse, its host.

Example: "https://api.honeycomb.io/v1/traces"

encodingstringRequired

OTLP body encoding; json for other kinds.

Values: "json""protobuf"

Example: "protobuf"

header_namesstring[]Required

Names of the saved headers. Values are never returned.

Show nested fields

See the OpenAPI schema for this nested object.

secret_hintstring | nullRequired

Last four characters of a webhook signing secret or Langfuse public key.

sample_ratenumberRequired

Share of requests sent. Sampling is per request, or per session_id when one is sent.

· Maximum 1

productsstring[]Required

Products traced; empty means all.

Show nested fields

See the OpenAPI schema for this nested object.

include_contentbooleanRequired

Also send LLM prompts and outputs as text. Never applied under zero data retention.

enabledbooleanRequired
created_atstringRequired
updated_atstringRequired
last_deliveryobjectRequired
Show nested fields
statusstring | nullRequired

The most recent batch's outcome; null before the first.

Values: "delivered""retrying""dead"null

status_codeinteger | nullRequired

HTTP status the destination answered with.

Example: 200

errorstring | nullRequired

Example: null

attempted_atstring | nullRequired
delivered_atstring | nullRequired

The last successful delivery.

pendingintegerRequired

Traces waiting to be delivered or retried.

deadintegerRequired

Traces that could not be delivered, kept for 7 days.

400Request validation failed.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

401Authentication is missing or invalid.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

403Authenticated principal lacks permission.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.

500Internal server error.
application/json
errorobjectRequired
Show nested fields
codestringRequired
messagestringRequired
paramstring | null
request_idstring | null
metadataobject

Typed detail for some refusals. budget_exceeded (402): limit (key_budget or workspace_budget) and budget with scope, period, limit, usage and resets_at. key_limit_exceeded (402): limit key_spend_limit. access_denied (403): policy (workspace or key), rule (models, providers or products), product, provider and model.