---
title: "How do you version OpenAI structured-output schemas without breaking an app?"  
description: "How do you version OpenAI structured-output schemas without breaking an app?"  
author: "Federica Bianchi"  
published: 2026-10-14  
updated: 2026-10-14  
canonical: https://www.mindstick.com/forum/162302/how-do-you-version-openai-structured-output-schemas-without-breaking-an-app  
category: "AI API Development"  
tags: ["OpenAI", "Structured Outputs", "API Design", "software development"]  
reading_time: 1 minute  

---

# How do you version OpenAI structured-output schemas without breaking an app?

I’m adding OpenAI structured outputs to a feature where the response feeds directly into existing application logic. The schema will probably change over time, but older clients may still expect the original fields and types.

How are you handling schema versioning in practice? Do you keep separate versions of the prompt and schema, or make new fields optional and maintain one compatible format? I’d be interested in what has worked once an integration is in production.


---

Original Source: https://www.mindstick.com/forum/162302/how-do-you-version-openai-structured-output-schemas-without-breaking-an-app

Copyright © MindStick Software Pvt. Ltd. This Markdown version is provided for developers, AI systems, and offline reading.