feat: new sdk reference page with snippets

[wassimoo]

Summary

Adds a new SDK reference page to the API docs, initially for Python, Go, and TypeScript.

Each operation now shows real, copy-pasteable SDK snippets (generated from the Ory SDKs) alongside cURL, instead of only auto-generated HTTP examples.

How it works

• Spec is the source of truth: The SDK snippets live inside the OpenAPI spec (src/static/api.json) as x-codeSamples entries on each operation.
• Injection script: scripts/inject-sdk-code-samples.mjs reads the generated Ory SDKs from the sibling ory/sdk repo and injects the Python, Go, and TypeScript samples into api.json:

Open questions

Right now the SDK samples are injected manually. We should automate this eg. the same way we currently update:

• A CI job in the SDK source repo runs the injection + regeneration whenever the SDKs/spec change.
• The bot opens a chore(docs): update of SDK reference PR against this repo with the regenerated api.json and reference docs.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 3259d7b7-6724-45ac-85b8-ea32cb8ee86d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• ✅ Review completed - (🔄 Check again to review again)

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/sdk-code-samples

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

• Generate code and open pull requests
• Plan features and break down work
• Investigate incidents and troubleshoot customer tickets together
• Automate recurring tasks and respond to alerts with triggers
• Summarize progress and report instantly

Built for teams:

• Shared memory across your entire org—no repeating context
• Per-thread sandboxes to safely plan and execute work
• Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[zepatrik]

Some of the colors don't work well with light mode.

I was also able to crash the page when switching to python.

Additionally, as a user I'd want to have a very good search on that page where I can:

1. free text say what I want to do, e.g. "create identity" or "import identity"
2. search by the SDKs method, e.g. "createIdentity"

We might not do the search right away, but IMO we should have it soon.

[unatasha8]

I still see the links "OpenAPI introduction" for example: https://docs-g60jtzv0z-ory.vercel.app/docs/sdk/new?language=go
docs-g60jtzv0z-ory.vercel.appOry Network SDK Reference | OryIndex of REST operations from the generated OpenAPI docs, grouped by tag.[6:04 PM]How about replacing this text: "Use the links below to jump to a specific operation, or start from the OpenAPI introductionm" with this instead "Use the links below to jump to a specific operation or use the search bar to find an operation."