---
title: "CreateObservabilityDestinationRequest"
---

## Fields

| Field                                                                                                                                                     | Type                                                                                                                                                      | Required                                                                                                                                                  | Description                                                                                                                                               | Example                                                                                                                                                   |
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `api_key_hashes`                                                                                                                                          | List[*str*]                                                                                                                                               | :heavy_minus_sign:                                                                                                                                        | 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. | null                                                                                                                                                      |
| `config`                                                                                                                                                  | Dict[str, *Nullable[Any]*]                                                                                                                                | :heavy_check_mark:                                                                                                                                        | Provider-specific configuration. The shape depends on `type` and is validated server-side.                                                                | \{<br/>"baseUrl": "https://us.cloud.langfuse.com",<br/>"publicKey": "pk-l...EfGh",<br/>"secretKey": "sk-l...AbCd"<br/>}                                    |
| `enabled`                                                                                                                                                 | *Optional[bool]*                                                                                                                                          | :heavy_minus_sign:                                                                                                                                        | Whether this destination should be enabled immediately.                                                                                                   | true                                                                                                                                                      |
| `filter_rules`                                                                                                                                            | [OptionalNullable[components.ObservabilityFilterRulesConfig]](../components/observabilityfilterrulesconfig.mdx)                                            | :heavy_minus_sign:                                                                                                                                        | Optional structured filter rules controlling which events are forwarded.                                                                                  | null                                                                                                                                                      |
| `name`                                                                                                                                                    | *str*                                                                                                                                                     | :heavy_check_mark:                                                                                                                                        | Human-readable name for the destination.                                                                                                                  | Production Langfuse                                                                                                                                       |
| `privacy_mode`                                                                                                                                            | *Optional[bool]*                                                                                                                                          | :heavy_minus_sign:                                                                                                                                        | When true, request/response bodies are not forwarded — only metadata.                                                                                     | false                                                                                                                                                     |
| `sampling_rate`                                                                                                                                           | *Optional[float]*                                                                                                                                         | :heavy_minus_sign:                                                                                                                                        | Sampling rate between 0.0001 and 1 (1 = 100%).                                                                                                            | 1                                                                                                                                                         |
| `type`                                                                                                                                                    | [components.CreateObservabilityDestinationRequestType](../components/createobservabilitydestinationrequesttype.mdx)                                        | :heavy_check_mark:                                                                                                                                        | The destination type. Only stable destination types are accepted.                                                                                         | langfuse                                                                                                                                                  |
| `workspace_id`                                                                                                                                            | *Optional[str]*                                                                                                                                           | :heavy_minus_sign:                                                                                                                                        | Optional workspace ID. Defaults to the authenticated entity's default workspace.                                                                          | 550e8400-e29b-41d4-a716-446655440000                                                                                                                      |