ONonkernel
Browser Telemetry

Update OTLP destination by ID or name

Changed on

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.

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

Path parameters

id_or_namestring required

OTLP destination ID or name

Request body

descriptionstring
endpointstring

Base endpoint of the OTLP/HTTP collector, without a signal path. Same rules as on create.

headersobject

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.

namestring

Response

OTLP destination updated

consecutive_failuresinteger 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_atstring date-time required
descriptionstring
endpointstring required

OTLP/HTTP endpoint telemetry is sent to.

headersobject 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.

idstring required
last_errorstring

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_atstring 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_atstring date-time

Timestamp of the most recent successful delivery. Moves only on success.

namestring required

Unique within the organization. Usable in place of the ID when selecting a destination, so it cannot be shaped like an ID.

updated_atstring date-time required

Changes

  • 0a840df52279Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

  • 27c36f01e110Revision changes
    • info

      endpoint added