---
title: "Update OTLP destination by ID or name"
method: PATCH
path: "/telemetry/destinations/{id_or_name}"
tags: ["Browser Telemetry"]
---

# Update OTLP destination by ID or name

`PATCH /telemetry/destinations/{id_or_name}`

## Request

- Base URL: `https://api.onkernel.com`
- URL: `https://api.onkernel.com/telemetry/destinations/{id_or_name}`
- Auth: HTTP bearer

Update an OTLP destination. Sessions already exporting to it pick up the new values without restarting, which makes this the way to rotate credentials without interrupting export.

Names must be unique within the organization. Renaming is refused with a 409 while a managed auth connection selects this destination by name, since that connection resolves the name on every login. Every other field, including `headers`, stays editable. Requires an organization-scoped credential or dashboard authentication; project-scoped credentials receive a 403.

## Path parameters

- `id_or_name` string, required

## Request body

- OTLPDestinationUpdateRequest: Fields to update. Omitted fields are left unchanged.
  - `description` string
  - `endpoint` string: Base endpoint of the OTLP/HTTP collector, without a signal path. Same rules as on create.
  - `headers` object: Edits stored headers key by key rather than replacing the map. A string value adds or replaces that header, `null` deletes it, and any key you omit is left as it is. Names are matched case-insensitively, so `authorization` replaces a stored `Authorization` rather than adding a second entry. This is the credential rotation path; sessions already exporting pick up the new values without restarting. Names and values must be valid HTTP header tokens, and the names and values together cannot exceed 8192 bytes.
  - `name` string

## Response `200`

OTLP destination updated

- OTLPDestination: An OTLP endpoint to export browser session telemetry to. Reference one from `telemetry.export.otlp.destination` when creating a browser to export that session's captured telemetry to it.
  - `consecutive_failures` integer, required: Failed deliveries since the last success, as observed by the relay process that wrote the latest outcome. Zero means the most recently recorded outcome succeeded.
  - `created_at` string, date-time, required
  - `description` string
  - `endpoint` string, required: OTLP/HTTP endpoint telemetry is sent to.
  - `headers` object, required: Headers sent with each export request. Names are returned in canonical form (`Authorization`, not `authorization`). Non-dashboard reads return values redacted as empty strings, so the keys are visible but the credentials are not. Dashboard reads return the stored values.
  - `id` string, required
  - `last_error` string: Sanitized class of the delivery failure recorded at `last_error_at`. It is retained after a later success, so its presence does not mean the destination is currently failing. Response bodies, endpoint URLs, credentials, and raw transport errors are never returned.
  - `last_error_at` string, date-time: Timestamp of the most recent failed delivery. It is retained after a later success, so it can predate `last_export_at`. Read `consecutive_failures` to tell whether the destination is currently failing.
  - `last_export_at` string, date-time: Timestamp of the most recent successful delivery. Moves only on success.
  - `name` string, required: Unique within the organization. Usable in place of the ID when selecting a destination, so it cannot be shaped like an ID.
  - `updated_at` string, date-time, required

## Other responses

- `400`: Bad Request – invalid input
- `401`: Unauthorized – missing or invalid authorization token
- `403`: Forbidden – insufficient permissions or plan
- `404`: Resource not found
- `409`: Conflict – resource already exists
- `500`: Internal Server Error

## Changes

- **2026-10-16** `03b369edee49`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kernel/apis/kernel-api/changes/telemetry/destinations/:id_or_name/patch.md)

---

[API](https://skmtc.dev/kernel/apis/kernel-api.md) - [All operations](https://skmtc.dev/kernel/apis/kernel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kernel/apis/kernel-api/revisions/0f6cf4f58fe6?raw)