| title | CreateObservabilityDestinationRequest |
|---|
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
api_key_hashes |
List[str] | ➖ | Optional allowlist of OpenRouter API key hashes whose traffic is forwarded. null or omitted means all keys. Must contain at least one hash if provided. A workspace-scoped management key can only name API keys in its own workspace; any other hash returns 400. |
null |
broadcast_generation_cost |
Optional[bool] | ➖ | When true, include cost and billing generation metadata. | false |
broadcast_generation_cost_allocation |
Optional[bool] | ➖ | Beta. When true, include openrouter_cost_allocation: per-token-kind usage and cost, sent only when they reconcile with the billed cost. | false |
broadcast_generation_identity |
Optional[bool] | ➖ | When true, include identity generation metadata. | false |
broadcast_generation_request_context |
Optional[bool] | ➖ | When true, include request-context generation metadata. | false |
config |
Dict[str, Any] | ✔️ | Provider-specific configuration. The shape depends on type and is validated server-side. |
{ "baseUrl": "https://us.cloud.langfuse.com", "publicKey": "pk-l...EfGh", "secretKey": "sk-l...AbCd" } |
enabled |
Optional[bool] | ➖ | Whether this destination should be enabled immediately. | true |
filter_rules |
OptionalNullable[components.ObservabilityFilterRulesConfigNullable] | ➖ | Optional structured filter rules controlling which events are forwarded. | null |
name |
str | ✔️ | Human-readable name for the destination. | Production Langfuse |
privacy_mode |
Optional[bool] | ➖ | When true, request/response bodies are not forwarded — only metadata. | false |
regions |
List[components.ObservabilityDataRegionInput] | ➖ | Data regions this destination applies to. eu is accepted as an alias for europe and normalizes to europe. Omitting this field defaults to ['global']; the array must be non-empty. |
[ "global" ] |
sampling_rate |
Optional[float] | ➖ | Sampling rate between 0.0001 and 1 (1 = 100%). | 1 |
type |
components.CreateObservabilityDestinationRequestType | ✔️ | The destination type. Only stable destination types are accepted. | langfuse |
workspace_id |
Optional[str] | ➖ | Optional workspace ID. Defaults to the authenticated entity's default workspace, or a workspace-scoped management key's own workspace. | 550e8400-e29b-41d4-a716-446655440000 |