Skip to content

docs(platform): document login --json and the cli's json error codes - #46

Merged
aikins01 merged 1 commit into
mainfrom
docs/platform/cli-json-errors
Oct 30, 2026
Merged

aikins01 merged 1 commit into
mainfrom
docs/platform/cli-json-errors

Conversation

@aikins01

Copy link
Copy Markdown
Contributor

The command line page now covers what scripts and agents get from --json in the newer CLI releases. It adds telemetry login --json, which prints the sign-in link and returns without opening a browser or waiting, and telemetry logout --json. A new Errors section gives the one-line JSON error format, what code, hint, and retryable mean, and the table of error codes.

Each statement says which CLI version it applies to. The JSON error format shipped in 0.1.1. login --json, logout --json, and the codes invalid_cursor, access_denied, trace_not_found, span_not_found, and server_error come in 0.1.2, from telemetry-dev/telemetry#131 and telemetry-dev/telemetry#134.

Merge after @telemetry-dev/cli 0.1.2 is on npm with both of those changes. If #134 ships in a later release, the version mentions for those codes need to change to that release.

@aikins01 aikins01 self-assigned this Oct 30, 2026
@aikins01
aikins01 merged commit 27f20cc into main Oct 30, 2026
1 check passed
@aikins01
aikins01 deleted the docs/platform/cli-json-errors branch October 30, 2026 15:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant