AI News
All stories
Official

Codex CLI 0.170.0 adds refreshable auth headers for OpenTelemetry HTTP exporters

Codex CLI 0.170.0 automatically refreshes authentication headers for OpenTelemetry HTTP exporters.

Products · · 1 min read

Codex CLI 0.170.0 lets OpenTelemetry HTTP exporters pick up fresh authentication headers without rebuilding their telemetry providers. The release notes list it as a new feature in a single line. The pull request that added it, #61028, explains how the mechanism works and where it is restricted.

The core of the change is a new setting, otel.headers_helper. It points to a command, run from CODEX_HOME, that returns a JSON object of header strings. Codex shares those results across every explicitly configured HTTP log, trace and metric exporter, so one helper serves all three signals. By default the helper runs every 29 minutes, and the otel.headers_helper_refresh_interval_ms setting changes that interval. In the pull request's own words, the stated purpose is to allow collector credentials to refresh without rebuilding OpenTelemetry providers.

The pull request also sets rules for failure and precedence. Headers returned by the helper override static headers with the same name. If a refresh fails, exports using those headers are blocked until the helper recovers. HTTP redirects are turned off whenever helper headers are in use. The helper cannot be set from repository-local configuration. Exporters configured by admin requirements, gRPC exporters and built-in analytics do not use the helper at all. Helper execution respects the network policy.

The described testing covers shared execution, credential refresh and recovery, blocked exports after a failure, network restrictions and configuration validation. Collector tests check header precedence across all three signals using both JSON and binary HTTP encodings, and they include exclusion of an admin-managed exporter. The pull request is a mirrored internal change, merged by a bot account named copyberry on November 12, 2026.

A separate changelog entry, #61018 by abhinav-oai, is titled "Extract HTTP headers helper execution into a shared crate." The release notes give the feature one sentence, and the linked release page does not describe the helper's configuration options or failure behavior. The pull request is therefore the only source for those details.

What changed

OpenTelemetry HTTP exporters can now pick up refreshed authentication headers from a new otel.headers_helper setting without rebuilding their telemetry providers.

Type: New capability · Applies to: Codex CLI 0.170.0, otel.headers_helper, otel.headers_helper_refresh_interval_ms

Why it matters

Organisations that send Codex CLI telemetry to monitoring systems that require authenticated HTTP export can keep exports working without manual header updates.

Original source

Where we saw it

1 source

Codex CLI releases

AI wrote this summary from the sources listed, and nobody reviewed it individually before publication. Check the original source before you rely on it. How it works