Skip to content

Commit b369e71

Browse files
Update migration guide from Apps SDK
1 parent 2f58643 commit b369e71

1 file changed

Lines changed: 11 additions & 10 deletions

File tree

docs/migrate_from_openai_apps.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -53,13 +53,13 @@ The server-side changes involve updating metadata structure and using helper fun
5353

5454
### CSP Field Mapping
5555

56-
| OpenAI | MCP Apps | Notes |
57-
| ------------------ | ----------------- | ---------------------------------------------------------- |
58-
| `resource_domains` | `resourceDomains` | Origins for static assets (images, fonts, styles, scripts) |
59-
| `connect_domains` | `connectDomains` | Origins for fetch/XHR/WebSocket requests |
60-
| `frame_domains` | `frameDomains` | Origins for nested iframes |
61-
| `redirect_domains` | | OpenAI-only: origins for `openExternal` redirects |
62-
|| `baseUriDomains` | MCP-only: `base-uri` CSP directive |
56+
| OpenAI | MCP Apps | Notes |
57+
| ------------------ | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
58+
| `resource_domains` | `resourceDomains` | Origins for static assets (images, fonts, styles, scripts) |
59+
| `connect_domains` | `connectDomains` | Origins for fetch/XHR/WebSocket requests |
60+
| `frame_domains` | `frameDomains` | Origins for nested iframes |
61+
| `redirect_domains` | `_meta.ui.linkTrustedDomains` | Origins `ui/open-link` may skip confirmation for. Note: this lives on `_meta.ui`, a sibling of `_meta.ui.csp`, not inside the CSP object. |
62+
|| `baseUriDomains` | MCP-only: `base-uri` CSP directive |
6363

6464
### Server-Side Migration Example
6565

@@ -255,9 +255,10 @@ Client-side migration involves replacing the implicit `window.openai` global wit
255255

256256
### External Links
257257

258-
| OpenAI | MCP Apps | Notes |
259-
| -------------------------------------------- | ----------------------------------- | ------------------------------------ |
260-
| `await window.openai.openExternal({ href })` | `await app.openLink({ url: href })` | Different param name: `href``url` |
258+
| OpenAI | MCP Apps | Notes |
259+
| -------------------------------------------- | ----------------------------------- | ---------------------------------------------------------------------------- |
260+
| `await window.openai.openExternal({ href })` | `await app.openLink({ url: href })` | Different param name: `href``url` |
261+
| `_meta["openai/widgetCSP"].redirect_domains` | `_meta.ui.linkTrustedDomains` | Origins that skip the host's link confirmation. Declared on the UI resource. |
261262

262263
### Display Mode
263264

0 commit comments

Comments
 (0)