Skip to content

refactor!: remove default organization model routes (#28632) - #28704

Merged
mtojek merged 1 commit into
backport/28542-to-2.37from
backport/28632-to-2.37
Aug 27, 2026
Merged

refactor!: remove default organization model routes (#28632)#28704
mtojek merged 1 commit into
backport/28542-to-2.37from
backport/28632-to-2.37

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Cherry-pick of #28632

Original PR: #28632 — refactor!: remove default organization model routes
Merge commit: 0f5c7b3
Requested by: @ethanndickson

@github-actions github-actions Bot added the cherry-pick/v2.37 Cherry-pick PR targeting release/2.37 label Aug 27, 2026
@github-actions
github-actions Bot requested a review from ethanndickson August 27, 2026 09:50
> [!IMPORTANT]
> Most of the added lines in this PR are generated API reference content
for publishing the organization-scoped `GET` and `POST
/api/v2/organizations/{organization}/chats/models` replacements. There
is no matching generated-doc deletion because the three removed
default-organization endpoints are experimental and are not present in
the generated public API reference on the current base. The removed
paths remain only as explicit 404 reservations, with no
default-organization shim or functional handler.

## Summary

Remove the unused default-organization chat model collection routes:

```text
GET  /api/experimental/chats/models
GET  /api/experimental/chats/model-configs
POST /api/experimental/chats/model-configs
```

Use the organization-scoped collection instead:

```text
GET  /api/v2/organizations/{organization}/chats/models
POST /api/v2/organizations/{organization}/chats/models
```

## Context

The intention of PR #28440 was to consolidate model availability into
the organization-scoped models collection for CODAGT-898 and remove the
superseded collection routes. That PR removed
`/organizations/{organization}/chats/models/available`, but it missed
these older default-organization routes and explicitly retained one of
them. This PR completes the intended #28440 cutover. The repository has
no SDK, CLI, or frontend consumer for the removed routes.

This change also prevents PR #28496 from promoting the missed
default-organization `/chats/models` route into the stable `/api/v2`
API.

This change is separate from the one-release `/api/experimental`
compatibility window in CODAGT-921. That window preserves experimental
versions of the intended stable API. It does not require compatibility
routes for unused deployment-scoped endpoints.

Refs CODAGT-898.

## Breaking change

Clients that call the removed routes must use the organization-scoped
model collection and provide an organization.

## Changelog

Remove unused default-organization Coder Agents model API routes. API
clients must use the organization-scoped chat models collection.

> [!NOTE]
> Coder Agents generated this pull request on Ethan Dickson's behalf.

(cherry picked from commit 0f5c7b3)
@ethanndickson
ethanndickson force-pushed the backport/28632-to-2.37 branch from 194afed to acbbeaf Compare August 27, 2026 10:15
@ethanndickson
ethanndickson changed the base branch from release/2.37 to backport/28542-to-2.37 August 27, 2026 10:15
@github-actions

Copy link
Copy Markdown
Contributor Author

Docs preview

Check off each page once it's been reviewed. If a page changes in a later push, its checkbox clears automatically so it gets a fresh look. Pages not yet wired into the docs navigation aren't listed here.

@ethanndickson
ethanndickson requested a review from mtojek August 27, 2026 10:18
@mtojek
mtojek merged commit aa209ae into release/2.37 Aug 27, 2026
33 of 54 checks passed
@mtojek
mtojek deleted the backport/28632-to-2.37 branch August 27, 2026 10:30
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 27, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

cherry-pick/v2.37 Cherry-pick PR targeting release/2.37

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants