Skip to content

Conversation

ashwinb
Copy link
Contributor

@ashwinb ashwinb commented Sep 27, 2025

The /v1/openai/v1 prefix is annoying and now unnecessary given our clearer focus on how to think about the API surface.

Let's kill it for the 0.3.0 update.

To make client-side changes feasible, we will do this in two parts. This part adds a new route (sans /openai/v1) so the existing client continues to work since the server supports both.

The next PR will be client-side (Stainless) changes which I will be making shortly.

The final PR will remove the /openai/v1 routes.

Note that all these changes will happen rapidly within this release cycle. The entire set will be backwards incompatible.

@meta-cla meta-cla bot added the CLA Signed This label is managed by the Meta Open Source bot. label Sep 27, 2025
Copy link
Collaborator

@mattf mattf left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

to give users a release to migrate, what do you think about using @cdoern 's technique of publishing these on /v1 and /v1/openai/v1?

@ashwinb
Copy link
Contributor Author

ashwinb commented Sep 29, 2025

to give users a release to migrate, what do you think about using @cdoern 's technique of publishing these on /v1 and /v1/openai/v1?

Why? We are breaking backwards compatibility with 0.3.0 -- what is the additional rationale for having both? Is there a reason I am missing?

@ashwinb ashwinb changed the title feat(openai_movement)!: Change URL structures to kill /openai/v1 feat(openai_movement): Change URL structures to kill /openai/v1 (part 1) Sep 29, 2025
Copy link
Contributor

@cdoern cdoern left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the API Conformance test is passing because its no longer checking anything given that it looks for v1/openai/v1. I can look into this in a follow up if you want, but instead of doing --match-path '^/v1/openai/v1' I think we now need to check for all APIs we want to ensure don't change (all of the ones that used to be behind the openai/v1)

@ashwinb
Copy link
Contributor Author

ashwinb commented Sep 29, 2025

@cdoern updated the osadiff workflow. please take a look.

@ashwinb ashwinb merged commit 5e7fed8 into llamastack:main Sep 29, 2025
22 checks passed
@ashwinb ashwinb deleted the openai_v1 branch September 29, 2025 23:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CLA Signed This label is managed by the Meta Open Source bot.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants