Update an observability destination | OpenRouter

curl -X PATCH https://openrouter.ai/api/v1/observability/destinations/99999999-aaaa-bbbb-cccc-dddddddddddd \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "enabled": false,
  "name": "Updated 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"
  }
}

Update an existing observability destination. Only the fields provided in the request body are updated. Management key required.

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Path parameters

idstringRequiredformat: "uuid"

The destination ID (UUID).

Request

This endpoint expects an object.

api_key_hasheslist of strings or nullOptional

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.

configmap from strings to anyOptional

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

enabledbooleanOptional

Whether the destination is enabled.

filter_rulesobjectOptional

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

namestringOptional

Human-readable name for the destination.

privacy_modebooleanOptional

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

sampling_ratedoubleOptional

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

Response

Destination updated successfully

dataobject

The updated observability destination.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error