alpha.decisions1

Analytics3

Anthropic Messages1

API Keys6

Batch4

Benchmarks1

BYOK5

Chat1

Classifications1

Containers4

Credits2

Datasets3

Embeddings2

Endpoints2

Files5

Generations3

Guardrails13

Images3

Interns10

Models4

OAuth4

Observability5

Organization1

Presets7

Providers1

Rerank1

Responses1

SCIM8

STT1

SystemOne1

TTS1

Vault7

Video Generation4

Workspaces12

Observability

Create an observability destination

Create a new observability destination. A maximum of 5 destinations per type is allowed. Defaults to the authenticated entity's default workspace; use the workspace_id body field to scope to a different workspace. Management key required.

post/observability/destinations

Request body

api_key_hashesstring[] nullable

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.

broadcast_generation_costboolean

When true, include cost and billing generation metadata.

broadcast_generation_identityboolean

When true, include identity generation metadata.

broadcast_generation_request_contextboolean

When true, include request-context generation metadata.

configobject required

Provider-specific configuration. The shape depends on type and is validated server-side.

enabledboolean

Whether this destination should be enabled immediately.

namestring required

Human-readable name for the destination.

privacy_modeboolean

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

regionsObservabilityDataRegionInput[]

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.

sampling_ratenumber double

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

The destination type. Only stable destination types are accepted.

workspace_idstring uuid

Optional workspace ID. Defaults to the authenticated entity's default workspace.

Example request

{
  "config": {
    "baseUrl": "https://us.cloud.langfuse.com",
    "publicKey": "pk-l...EfGh",
    "secretKey": "sk-l...AbCd"
  },
  "name": "Production Langfuse",
  "type": "langfuse"
}

Response

Destination created successfully

Example response

{
  "data": {
    "api_key_hashes": null,
    "broadcast_generation_cost": false,
    "broadcast_generation_identity": false,
    "broadcast_generation_request_context": false,
    "config": {
      "baseUrl": "https://us.cloud.langfuse.com",
      "publicKey": "pk-l...EfGh",
      "secretKey": "sk-l...AbCd"
    },
    "created_at": "2025-08-24T10:30:00Z",
    "enabled": true,
    "filter_rules": null,
    "id": "99999999-aaaa-bbbb-cccc-dddddddddddd",
    "name": "Production Langfuse",
    "privacy_mode": false,
    "regions": [
      "global"
    ],
    "sampling_rate": 1,
    "type": "langfuse",
    "updated_at": "2025-08-24T15:45:00Z",
    "workspace_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Changes

Changed in 5 of the 303 revisions of this API.374

Sep 5, 202632df6bd56db218See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
Aug 24, 20268a2854d36d2d1See the full diff
- ○
  the response's property default value changed from https://api.us5.datadoghq.com to https://api.datadoghq.com for the status
  response-property-default-value-changed
Aug 7, 20266b6ae78fb2f354See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
- ○
  added the required property ///////// to the response with the status
  response-required-property-added
Aug 4, 2026820fa3eba68d1See the full diff
- ○
  the ////////// response's property pattern ^[a-zA-Z0-9_]+(?:[.-][a-zA-Z0-9_]+)*$ was added for the status
  response-property-pattern-added
Jul 16, 2026c91cc6f88caa3See the full diff
- ▲
  the request property became not nullable
  request-property-became-not-nullable
- ▲
  the request property / became not nullable
  request-property-became-not-nullable
- ▲
  the request property became not nullable
  request-property-became-not-nullable

Full history