OpenAI · api
v1/prompts deprecation: shutdown date & replacement
- Provider
- OpenAI
- Name
- Reusable prompts (v1/prompts API)
- Type
- api
- Announced
- Shutdown
- Replacement
- —
- Source
- Official OpenAI notice
Reusable prompt objects and the v1/prompts API; move prompt content into application code.
How to migrate off v1/prompts
- Find every place that references it:
grep -rn --exclude-dir={node_modules,.git,dist} "v1/prompts" . - Follow the provider’s migration notes in the official notice.
- Re-run your evals or a sample of real prompts — output style, token usage and pricing can change between APIs.
- Check config outside code too: environment variables, feature flags, prompt-management tools, and fine-tuned model references.
- Deploy before November 30, 2026, and add the CI scanner so it cannot come back.
Also shutting down on November 30, 2026 (OpenAI)
Questions
Is v1/prompts deprecated?
Yes. OpenAI has deprecated v1/prompts. It shuts down on November 30, 2026.
When does v1/prompts shut down?
November 30, 2026, according to OpenAI's official deprecation notice.
What should I use instead of v1/prompts?
OpenAI has not named a specific replacement. Check the official source for current models.
What happens to requests to v1/prompts after the shutdown?
Requests using the retired model ID fail with an error, so any code still calling it breaks. Update and deploy before the shutdown date.