use-cases/api-integration-migrations.md Codex Docs, 2026-03-31 06:35 UTC → 2026-04-18 18:18 UTC

1# Upgrade your API integration | Codex use cases1# Upgrade your API integration | Codex use cases

2 2 

3Codex use cases

4 

5![](/assets/OpenAI-black-wordmark.svg)

6 

7![Codex](/assets/OAI_Codex-Lockup_Fallback_Black.svg)

8 

9Codex use case

10 

11# Upgrade your API integration

12 

13Upgrade your app to the latest OpenAI API models.

14 

15Difficulty **Intermediate**

16 

17Time horizon **1h**

18 

19Use Codex to update your existing OpenAI API integration to the latest recommended models and API features, while checking for regressions before you ship.

20 

21## Best for

22 

23 - Teams upgrading from older models or API surfaces

24 - Repos that need behavior-preserving migrations with explicit validation

25 

26# Contents

27 

3[← All use cases](https://developers.openai.com/codex/use-cases)28[← All use cases](https://developers.openai.com/codex/use-cases)

4 29 

30Copy page [Export as PDF](https://developers.openai.com/codex/use-cases/api-integration-migrations/?export=pdf)

31 

5Use Codex to update your existing OpenAI API integration to the latest recommended models and API features, while checking for regressions before you ship.32Use Codex to update your existing OpenAI API integration to the latest recommended models and API features, while checking for regressions before you ship.

6 33 

7Intermediate34Intermediate

23 50 

24 Pull the current model, migration, and API guidance before Codex makes edits to your implementation.51 Pull the current model, migration, and API guidance before Codex makes edits to your implementation.

25 52 

53| Skill | Why use it |

54| --- | --- |

55| [OpenAI Docs](https://github.com/openai/skills/tree/main/skills/.curated/openai-docs) | Pull the current model, migration, and API guidance before Codex makes edits to your implementation. |

56 

26## Starter prompt57## Starter prompt

27 58 

28Use $openai-docs to upgrade this OpenAI integration to the latest recommended model and API features.59Use $openai-docs to upgrade this OpenAI integration to the latest recommended model and API features.

34 - Update prompts using the latest model prompt guidance. 65 - Update prompts using the latest model prompt guidance.

35- Call out any prompt, tool, or response-shape changes we need to review manually.66- Call out any prompt, tool, or response-shape changes we need to review manually.

36 67 

68[Open in the Codex app](codex://new?prompt=Use+%24openai-docs+to+upgrade+this+OpenAI+integration+to+the+latest+recommended+model+and+API+features.%0A%0ASpecifically%2C+look+for+the+latest+model+and+prompt+guidance+for+this+specific+model.%0A%0ARequirements%3A%0A-+Start+by+inventorying+the+current+models%2C+endpoints%2C+and+tool+assumptions+in+the+repo.%0A-+Identify+the+smallest+migration+plan+that+gets+us+onto+the+latest+supported+path.%0A-+Preserve+behavior+unless+a+change+is+required+by+the+new+API+or+model.%0A-+Update+prompts+using+the+latest+model+prompt+guidance.+%0A-+Call+out+any+prompt%2C+tool%2C+or+response-shape+changes+we+need+to+review+manually. "Open in the Codex app")

69 

70Use $openai-docs to upgrade this OpenAI integration to the latest recommended model and API features.

71Specifically, look for the latest model and prompt guidance for this specific model.

72 Requirements:

73- Start by inventorying the current models, endpoints, and tool assumptions in the repo.

74- Identify the smallest migration plan that gets us onto the latest supported path.

75 - Preserve behavior unless a change is required by the new API or model.

76 - Update prompts using the latest model prompt guidance.

77- Call out any prompt, tool, or response-shape changes we need to review manually.

78 

37## Introduction79## Introduction

38 80 

39As we release new models and API features, we recommend upgrading your integration to benefit from the latest improvements.81As we release new models and API features, we recommend upgrading your integration to benefit from the latest improvements.

61 103 

62## Related use cases104## Related use cases

63 105 

64[![](/images/codex/codex-wallpaper-1.webp)106[![](/images/codex/codex-wallpaper-2.webp)

65 107 

66### Create browser-based games108### Add Mac telemetry

67 109 

68Use Codex to turn a game brief into first a well-defined plan, and then a real browser-based...110Use Codex and the Build macOS Apps plugin to add a few high-signal `Logger` events around...

69 111 

70Engineering Code](https://developers.openai.com/codex/use-cases/browser-games)[![](/images/codex/codex-wallpaper-1.webp)112macOS Code](https://developers.openai.com/codex/use-cases/macos-telemetry-logs)[![](/images/codex/codex-wallpaper-2.webp)

71 113 

72### Bring your app to ChatGPT114### Create a CLI Codex can use

73 115 

74Build one narrow ChatGPT app outcome end to end: define the tools, scaffold the MCP server...116Ask Codex to create a composable CLI it can run from any folder, combine with repo scripts...

75 117 

76Integrations Code](https://developers.openai.com/codex/use-cases/chatgpt-apps)[![](/images/codex/codex-wallpaper-3.webp)118Engineering Code](https://developers.openai.com/codex/use-cases/agent-friendly-clis)[![](/images/codex/codex-wallpaper-1.webp)

77 119 

78### Build for iOS and macOS120### Create browser-based games

79 121 

80Use Codex to scaffold SwiftUI projects, keep the build loop CLI-first with `xcodebuild` or...122Use Codex to turn a game brief into first a well-defined plan, and then a real browser-based...

81 123 

82Mobile Code](https://developers.openai.com/codex/use-cases/native-ios-macos-apps)124Engineering Code](https://developers.openai.com/codex/use-cases/browser-games)