Skip to main content
PATCH
Update an observability destination

Authorizations

Authorization
string
header
required

API key as bearer token in Authorization header

Path Parameters

id
string<uuid>
required

The destination ID (UUID).

Example:

"99999999-aaaa-bbbb-cccc-dddddddddddd"

Body

application/json
api_key_hashes
string[] | null

Optional allowlist of OpenRouter API key hashes. null clears the filter (all keys). Omitting leaves the current value. Must contain at least one hash if provided. Every hash must belong to an API key in the destination's workspace; any other hash returns 400. A hash the destination already lists is kept even if that key has since moved to another workspace, so an already-listed hash can always be written back.

Minimum array length: 1
Example:

null

broadcast_generation_cost
boolean

Whether to include cost and billing generation metadata.

Example:

false

broadcast_generation_cost_allocation
boolean

Beta. When true, include openrouter_cost_allocation: per-token-kind usage and cost, sent only when they reconcile with the billed cost.

Example:

false

broadcast_generation_identity
boolean

Whether to include identity generation metadata.

Example:

false

broadcast_generation_request_context
boolean

Whether to include request-context generation metadata.

Example:

false

config
object

Provider-specific configuration fields to update. Masked values are ignored; unset fields keep their current value.

Example:
enabled
boolean

Whether the destination is enabled.

Example:

true

filter_rules
object | null

Optional structured filter rules. null clears the rules. Omitting keeps the current value.

Example:

null

name
string

Human-readable name for the destination.

Example:

"Production Langfuse"

privacy_mode
boolean

When true, request/response bodies are not forwarded — only metadata.

Example:

false

regions
enum<string>[]

Data regions this destination applies to. eu is accepted as an alias for europe and normalizes to europe. Omitting this field keeps the current value; it cannot be cleared.

Minimum array length: 1

eu is accepted as an alias for europe and normalizes to europe.

Available options:
global,
europe,
us,
eu
Example:
sampling_rate
number<double>

Sampling rate between 0.0001 and 1 (1 = 100%).

Example:

1

Response

Destination updated successfully

data
object
required

The updated observability destination.

Example: