Create an observability destination | OpenRouter

curl -X POST https://openrouter.ai/api/v1/observability/destinations \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "config": {
    "baseUrl": "https://us.cloud.langfuse.com",
    "publicKey": "pk-l...EfGh",
    "secretKey": "sk-l...AbCd"
  },
  "name": "Production Langfuse",
  "type": "langfuse"
}'

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

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.

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Request

This endpoint expects an object.

configmap from strings to anyRequired

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

namestringRequired

Human-readable name for the destination.

typeenumRequired

The destination type. Only stable destination types are accepted.

api_key_hasheslist of strings or nullOptional

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.

enabledbooleanOptionalDefaults to true

Whether this destination should be enabled immediately.

filter_rulesobjectOptional

Optional structured filter rules controlling which events are forwarded.

privacy_modebooleanOptionalDefaults to false

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

sampling_ratedoubleOptional

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

workspace_idstringOptionalformat: "uuid"

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

Response

Destination created successfully

dataobject

The newly created observability destination.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

500

Internal Server Error