Skip to content

Add unified OpenAPI spec sync workflow - #205

Open
zacchua-stripe wants to merge 6 commits into
masterfrom
zacchua/sync-openapi-specs
Open

zacchua-stripe wants to merge 6 commits into
masterfrom
zacchua/sync-openapi-specs

Conversation

@zacchua-stripe

@zacchua-stripe zacchua-stripe commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

Why?

Unified public-preview and GA OpenAPI artifacts are now being published to the CDN for release. This PR updates creates a github action to download the unified specs, v1 spec and fixtures.

What?

  • Added sync-openapi-specs.yml workflow supporting:
    • Private preview, public preview, GA, and combined GA/public-preview syncing.
    • Optional unified-spec syncing.
    • Dry-run, test-branch, and release modes.
  • Added scripts to:
    • Download split specs and (optional) fixtures from the CDN.
    • Download unified specs when unified=true.
    • Create and push OpenAPI release tags.
      • GH actions triggered by unified spec workflows will have [unified] in the tag message. publish.yml will read the tag message and trigger sdk-codegen in unified mode.
  • Converted publish-v1-specs.yaml into a wrapper so existing private-preview publishing workflows continue to work.
    • Will need to migrate these to sync-openapi-specs.yml then we can delete publish-v1-specs.yml
  • Download split specs and fixtures under openapi/, while unified specs are downloaded under latest/ and preview/.

See Also

http://go/j/DEVSDK-3333

zacchua-stripe and others added 4 commits October 15, 2026 14:47
Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>
Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>
Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>
Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>
Comment thread .github/scripts/download-openapi-specs.sh Outdated
Comment thread .github/scripts/sync-openapi-specs.sh Outdated
Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>
@zacchua-stripe
zacchua-stripe marked this pull request as ready for review October 16, 2026 00:16
Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant