Skip to content

docs: clarify that deprecation does not remove the latest flag - #1854

Merged
rdimitrov merged 1 commit into
mainfrom
codex/clarify-latest-deprecation
Nov 12, 2026
Merged

rdimitrov merged 1 commit into
mainfrom
codex/clarify-latest-deprecation

Conversation

@rdimitrov

Copy link
Copy Markdown
Member

A deprecated server version can remain isLatest: true, which led clients in #1819 to interpret latest as active. Clarify that deprecation alone does not remove the flag and that clients must check lifecycle status separately. Explain that selecting an older active version requires inspecting version history and applying a client policy.

Update the API reference, metadata guide, checked-in OpenAPI description, and runtime schema description consistently. Runtime selection behavior is unchanged.

Validation: make validate and git diff --check passed.

@rdimitrov
rdimitrov merged commit 899011e into main Nov 12, 2026
9 checks passed
@rdimitrov
rdimitrov deleted the codex/clarify-latest-deprecation branch November 12, 2026 18:12
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