5:[["$","$L20",null,{"className":"container-sm docs-mobile-menu md:hidden","menuData":[{"name":"index","route":"/blog","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:1:frontMatter","title":"Blog | Speakeasy","type":"doc","isUnderCurrentDocsTree":true},{"name":"5-potential-use-cases-for-Arazzo","route":"/blog/5-potential-use-cases-for-Arazzo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:2:frontMatter","title":"5 potential use cases for Arazzo","type":"doc","isUnderCurrentDocsTree":true},{"name":"a-copilot-for-your-api-spec-and-pagination","route":"/blog/a-copilot-for-your-api-spec-and-pagination","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:3:frontMatter","title":"A Copilot for your API spec and Pagination","type":"doc","isUnderCurrentDocsTree":true},{"name":"a-dev-portal-on-demand","route":"/blog/a-dev-portal-on-demand","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:4:frontMatter","title":"A Dev Portal on Demand","type":"doc","isUnderCurrentDocsTree":true},{"name":"a-monorepo-for-your-sdks","route":"/blog/a-monorepo-for-your-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:5:frontMatter","title":"A MonoRepo For Your SDKs","type":"doc","isUnderCurrentDocsTree":true},{"name":"add-prompts-to-your-mcp-server","route":"/blog/add-prompts-to-your-mcp-server","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:6:frontMatter","title":"Add prompts to your MCP server","type":"doc","isUnderCurrentDocsTree":true},{"name":"announcing-easysdk-generator","route":"/blog/announcing-easysdk-generator","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:7:frontMatter","title":"Announcing: EasySDK Generator","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-auth-guide","route":"/blog/api-auth-guide","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:8:frontMatter","title":"Guide to API Auth & A Novel Approach","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-change-detection-open-enums","route":"/blog/api-change-detection-open-enums","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:9:frontMatter","title":"API Change Detection & Open Enums","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-design","route":"/blog/api-design","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:10:frontMatter","title":"Designing your API: Find the RESTful sweet spot","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-experts-akshat-agrawal","route":"/blog/api-experts-akshat-agrawal","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:11:frontMatter","title":"API Experts - APIs That Build APIs","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-experts-clarence-chio","route":"/blog/api-experts-clarence-chio","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:12:frontMatter","title":"API Experts - APIs to Fight Fraud","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-experts-jack-reed","route":"/blog/api-experts-jack-reed","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:13:frontMatter","title":"API Experts - APIs that Move Money","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-experts-mathias-vagni","route":"/blog/api-experts-mathias-vagni","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:14:frontMatter","title":"API Experts - APIs to Support your Customers","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-key-management","route":"/blog/api-key-management","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:15:frontMatter","title":"API Key Management","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-landscape","route":"/blog/api-landscape","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:16:frontMatter","title":"The Speakeasy API Landscape","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-linting-postman-generation","route":"/blog/api-linting-postman-generation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:17:frontMatter","title":"API Linting & Postman Generation","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-ops-usage-monitoring","route":"/blog/api-ops-usage-monitoring","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:18:frontMatter","title":"API Ops - The Difficulties In Monitoring API Usage","type":"doc","isUnderCurrentDocsTree":true},{"name":"apis-for-global-shipping","route":"/blog/apis-for-global-shipping","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:19:frontMatter","title":"API Experts - Shipping APIs for Global Shipping","type":"doc","isUnderCurrentDocsTree":true},{"name":"apis-vs-sdks-difference","route":"/blog/apis-vs-sdks-difference","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:20:frontMatter","title":"APIs vs. SDKs: Key Differences, Use Cases, and Best Practices","type":"doc","isUnderCurrentDocsTree":true},{"name":"auth-for-embedded-react-components","route":"/blog/auth-for-embedded-react-components","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:21:frontMatter","title":"How to Handle Auth for Embedded React Components","type":"doc","isUnderCurrentDocsTree":true},{"name":"automate-oauth-flows-streamline-publishing","route":"/blog/automate-oauth-flows-streamline-publishing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:22:frontMatter","title":"Automate your OAuth flows and streamline publishing","type":"doc","isUnderCurrentDocsTree":true},{"name":"automated-code-samples-overlay-management-in-speakeasy-studio","route":"/blog/automated-code-samples-overlay-management-in-speakeasy-studio","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:23:frontMatter","title":"Automated Code Samples & Overlay Management in Speakeasy Studio!","type":"doc","isUnderCurrentDocsTree":true},{"name":"build-a-mcp-server-tutorial","route":"/blog/build-a-mcp-server-tutorial","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:24:frontMatter","title":"Building a Model Context Protocol (MCP) server for Discord","type":"doc","isUnderCurrentDocsTree":true},{"name":"build-custom-workflows-sneak-peak","route":"/blog/build-custom-workflows-sneak-peak","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:25:frontMatter","title":"Build Custom Workflows - Sneak Peak!","type":"doc","isUnderCurrentDocsTree":true},{"name":"build-terraform-providers","route":"/blog/build-terraform-providers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:26:frontMatter","title":"Building a SaaS API? Don't Forget Your Terraform Provider","type":"doc","isUnderCurrentDocsTree":true},{"name":"building-php-sdks","route":"/blog/building-php-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:27:frontMatter","title":"How to Build an SDK in PHP","type":"doc","isUnderCurrentDocsTree":true},{"name":"c-general-availability-our-ai-enhanced-cli","route":"/blog/c-general-availability-our-ai-enhanced-cli","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:28:frontMatter","title":"C# General Availability & our AI-enhanced CLI","type":"doc","isUnderCurrentDocsTree":true},{"name":"choosing-a-docs-vendor","route":"/blog/choosing-a-docs-vendor","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:29:frontMatter","title":"Choosing a docs vendor: Mintlify vs Scalar vs Bump vs ReadMe vs Redocly","type":"doc","isUnderCurrentDocsTree":true},{"name":"choosing-your-framework-python","route":"/blog/choosing-your-framework-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:30:frontMatter","title":"Choosing your Python REST API framework","type":"doc","isUnderCurrentDocsTree":true},{"name":"contract-testing-with-openapi","route":"/blog/contract-testing-with-openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:31:frontMatter","title":"Contract testing with OpenAPI","type":"doc","isUnderCurrentDocsTree":true},{"name":"create-a-terraform-provider-a-guide-for-beginners","route":"/blog/create-a-terraform-provider-a-guide-for-beginners","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:32:frontMatter","title":"How To Create a Terraform Provider — a Guide for Absolute Beginners","type":"doc","isUnderCurrentDocsTree":true},{"name":"custom-code-regions-an-overlay-playground","route":"/blog/custom-code-regions-an-overlay-playground","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:33:frontMatter","title":"Custom code regions & an Overlay playground!","type":"doc","isUnderCurrentDocsTree":true},{"name":"custom-type-support-in-terraform","route":"/blog/custom-type-support-in-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:34:frontMatter","title":"Custom type support in Terraform","type":"doc","isUnderCurrentDocsTree":true},{"name":"customisable-imports-openapi-overlays-and-terraform-generation-improvements","route":"/blog/customisable-imports-openapi-overlays-and-terraform-generation-improvements","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:35:frontMatter","title":"Customisable Imports, OpenAPI Overlays, and Terraform generation improvements!","type":"doc","isUnderCurrentDocsTree":true},{"name":"definitive-guide-to-devex-portals","route":"/blog/definitive-guide-to-devex-portals","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:36:frontMatter","title":"Definitive Guide to API DevEx Portals","type":"doc","isUnderCurrentDocsTree":true},{"name":"design-responses","route":"/blog/design-responses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:37:frontMatter","title":"Designing REST APIs: Responses Your Users Expect","type":"doc","isUnderCurrentDocsTree":true},{"name":"devex-portals-as-a-service","route":"/blog/devex-portals-as-a-service","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:38:frontMatter","title":"DevEx portals as a service","type":"doc","isUnderCurrentDocsTree":true},{"name":"dynamic-dev-portals-with-speakeasy-components","route":"/blog/dynamic-dev-portals-with-speakeasy-components","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:39:frontMatter","title":"Dynamic Dev Portals with Speakeasy Components","type":"doc","isUnderCurrentDocsTree":true},{"name":"e2e-testing-arazzo","route":"/blog/e2e-testing-arazzo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:40:frontMatter","title":"End-to-end API testing with Arazzo, TypeScript, and Deno","type":"doc","isUnderCurrentDocsTree":true},{"name":"early-access-for-universal-typescript-sdk-and-sdk-docs","route":"/blog/early-access-for-universal-typescript-sdk-and-sdk-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:41:frontMatter","title":"Early Access for Universal Typescript SDK and SDK Docs","type":"doc","isUnderCurrentDocsTree":true},{"name":"easy-validation-for-openapi","route":"/blog/easy-validation-for-openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:42:frontMatter","title":"Easy Validation For OpenAPI","type":"doc","isUnderCurrentDocsTree":true},{"name":"easytemplate-release","route":"/blog/easytemplate-release","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:43:frontMatter","title":"EasyTemplate OSS Release: Templating Superpowers for Go","type":"doc","isUnderCurrentDocsTree":true},{"name":"enforcing-api-consistency","route":"/blog/enforcing-api-consistency","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:44:frontMatter","title":"Enforcing API consistency","type":"doc","isUnderCurrentDocsTree":true},{"name":"fundraising-series-a","route":"/blog/fundraising-series-a","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:45:frontMatter","title":"Speakeasy's $15M Series A","type":"doc","isUnderCurrentDocsTree":true},{"name":"hathora-gaming-devex","route":"/blog/hathora-gaming-devex","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:46:frontMatter","title":"Game Dev & The Rise of Developer Experience","type":"doc","isUnderCurrentDocsTree":true},{"name":"hiring-a-founding-team","route":"/blog/hiring-a-founding-team","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:47:frontMatter","title":"A New Approach to Hiring A Founding Team","type":"doc","isUnderCurrentDocsTree":true},{"name":"how-to-build-sdks","route":"/blog/how-to-build-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:48:frontMatter","title":"How to Build SDKs for Your API: Handwritten, OpenAPI Generator, or Speakeasy?","type":"doc","isUnderCurrentDocsTree":true},{"name":"how-to-build-terraform-providers","route":"/blog/how-to-build-terraform-providers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:49:frontMatter","title":"How to Generate Terraform Providers","type":"doc","isUnderCurrentDocsTree":true},{"name":"how-to-create-a-custom-python-sdk","route":"/blog/how-to-create-a-custom-python-sdk","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:50:frontMatter","title":"How To Build A Best In Class Python SDK","type":"doc","isUnderCurrentDocsTree":true},{"name":"how-to-generate-a-mock-server","route":"/blog/how-to-generate-a-mock-server","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:51:frontMatter","title":"How to generate a mock server to test SDKs","type":"doc","isUnderCurrentDocsTree":true},{"name":"how-to-set-operationid","route":"/blog/how-to-set-operationid","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:52:frontMatter","title":"OpenAPI Tips - How to set operationId","type":"doc","isUnderCurrentDocsTree":true},{"name":"how-we-built-cli","route":"/blog/how-we-built-cli","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:53:frontMatter","title":"Why and How we invested in building a best in class CLI","type":"doc","isUnderCurrentDocsTree":true},{"name":"how-we-built-universal-ts","route":"/blog/how-we-built-universal-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:54:frontMatter","title":"How We Built It - Universal Typescript","type":"doc","isUnderCurrentDocsTree":true},{"name":"improved-devex-with-flattened-sdks","route":"/blog/improved-devex-with-flattened-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:55:frontMatter","title":"Improved DevEX with Flattened SDKs","type":"doc","isUnderCurrentDocsTree":true},{"name":"integrate-with-your-favorite-docs-provider","route":"/blog/integrate-with-your-favorite-docs-provider","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:56:frontMatter","title":"Integrate with Your Favorite Docs Provider!","type":"doc","isUnderCurrentDocsTree":true},{"name":"internal-sdks","route":"/blog/internal-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:57:frontMatter","title":"Building SDKs for internal APIs: How to Boost developer velocity","type":"doc","isUnderCurrentDocsTree":true},{"name":"introducing-speakeasy","route":"/blog/introducing-speakeasy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:58:frontMatter","title":"Speakeasy's $11M Raise","type":"doc","isUnderCurrentDocsTree":true},{"name":"introducing-universal-ts","route":"/blog/introducing-universal-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:59:frontMatter","title":"Introducing Universal TypeScript: A TS SDK your users will love","type":"doc","isUnderCurrentDocsTree":true},{"name":"java-general-availability-and-managed-oauth-support","route":"/blog/java-general-availability-and-managed-oauth-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:60:frontMatter","title":"Java General Availability and managed OAuth support","type":"doc","isUnderCurrentDocsTree":true},{"name":"java-sdks-telemetry","route":"/blog/java-sdks-telemetry","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:61:frontMatter","title":"Java SDKs & Telemetry","type":"doc","isUnderCurrentDocsTree":true},{"name":"label-based-versioning-openapi-transformations-and-overlay-insights","route":"/blog/label-based-versioning-openapi-transformations-and-overlay-insights","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:62:frontMatter","title":"Label-Based Versioning, OpenAPI Transformations, and Overlay Insights","type":"doc","isUnderCurrentDocsTree":true},{"name":"langchain-vs-haystack-api-tools","route":"/blog/langchain-vs-haystack-api-tools","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:63:frontMatter","title":"Building an AI agent with OpenAPI: LangChain vs. Haystack","type":"doc","isUnderCurrentDocsTree":true},{"name":"last-changelog-of-the-year-looking-ahead-and-a-thank-you","route":"/blog/last-changelog-of-the-year-looking-ahead-and-a-thank-you","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:64:frontMatter","title":"Last changelog of the year, looking ahead, and a thank you!","type":"doc","isUnderCurrentDocsTree":true},{"name":"launch-week-0-round-up-webhooks-react-query-support-more","route":"/blog/launch-week-0-round-up-webhooks-react-query-support-more","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:65:frontMatter","title":"Launch week 0 round up: webhooks, react query support & more!","type":"doc","isUnderCurrentDocsTree":true},{"name":"lean-typescript-sdks-for-the-browser","route":"/blog/lean-typescript-sdks-for-the-browser","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:66:frontMatter","title":"Lean TypeScript SDKs for the browser","type":"doc","isUnderCurrentDocsTree":true},{"name":"loom-for-remote-collaboration","route":"/blog/loom-for-remote-collaboration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:67:frontMatter","title":"Using Loom for Remote Collaboration","type":"doc","isUnderCurrentDocsTree":true},{"name":"mintlify-integration-plan-validators-and-python-async-beta","route":"/blog/mintlify-integration-plan-validators-and-python-async-beta","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:68:frontMatter","title":"Mintlify Integration, Plan Validators, and Python Async Beta","type":"doc","isUnderCurrentDocsTree":true},{"name":"more-apis-less-complexity","route":"/blog/more-apis-less-complexity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:69:frontMatter","title":"More APIs, Less Complexity","type":"doc","isUnderCurrentDocsTree":true},{"name":"native-jsonl-support-in-your-sdks","route":"/blog/native-jsonl-support-in-your-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:70:frontMatter","title":"Native JSONL support in your SDKs","type":"doc","isUnderCurrentDocsTree":true},{"name":"nivo-vs-recharts","route":"/blog/nivo-vs-recharts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:71:frontMatter","title":"Nivo vs Recharts - Which should you use?","type":"doc","isUnderCurrentDocsTree":true},{"name":"on-demand-publishing-pre-releases","route":"/blog/on-demand-publishing-pre-releases","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:72:frontMatter","title":"On Demand Publishing & Pre-Releases","type":"doc","isUnderCurrentDocsTree":true},{"name":"one-click-request-sharing","route":"/blog/one-click-request-sharing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:73:frontMatter","title":"One-click Request Sharing","type":"doc","isUnderCurrentDocsTree":true},{"name":"open-enums","route":"/blog/open-enums","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:74:frontMatter","title":"Evolving enums for evolving APIs","type":"doc","isUnderCurrentDocsTree":true},{"name":"open-source-pledge-2024","route":"/blog/open-source-pledge-2024","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:75:frontMatter","title":"$$40,000 for OSS maintainers","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-has-flaws","route":"/blog/openapi-has-flaws","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:76:frontMatter","title":"OpenAPI has flaws, so what?","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-reference-guide","route":"/blog/openapi-reference-guide","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:77:frontMatter","title":"Everything You Need to Know About OpenAPI","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-servers","route":"/blog/openapi-servers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:78:frontMatter","title":"Defining OpenAPI Servers - The Where To Your API's How","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-spec-drift-detection","route":"/blog/openapi-spec-drift-detection","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:79:frontMatter","title":"OpenAPI Spec Drift Detection","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-studio-laravel-integration-and-what-in-zod-s-name","route":"/blog/openapi-studio-laravel-integration-and-what-in-zod-s-name","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:80:frontMatter","title":"OpenAPI Studio, Laravel Integration, and 'what in Zod's name?'","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-tips-auth","route":"/blog/openapi-tips-auth","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:81:frontMatter","title":"OpenAPI Tips - How to Handle Auth","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-tips-data-type-formats","route":"/blog/openapi-tips-data-type-formats","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:82:frontMatter","title":"OpenAPI tips - Data types and formats","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-tips-oneof-allof-anyof","route":"/blog/openapi-tips-oneof-allof-anyof","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:83:frontMatter","title":"OneOf, AllOf, AnyOf Oh my! How to define union types in OpenAPI","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-tips-query-parameters-serialization","route":"/blog/openapi-tips-query-parameters-serialization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:84:frontMatter","title":"OpenAPI Tips - Query Parameters & Serialization","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-tips-webhooks-callbacks","route":"/blog/openapi-tips-webhooks-callbacks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:85:frontMatter","title":"Webhooks & Callbacks in OpenAPI/Swagger","type":"doc","isUnderCurrentDocsTree":true},{"name":"openapi-webhook-support","route":"/blog/openapi-webhook-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:86:frontMatter","title":"OpenAPI Webhook Support","type":"doc","isUnderCurrentDocsTree":true},{"name":"our-series-a-fundraise","route":"/blog/our-series-a-fundraise","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:87:frontMatter","title":"Our Series A fundraise","type":"doc","isUnderCurrentDocsTree":true},{"name":"pact-vs-openapi","route":"/blog/pact-vs-openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:88:frontMatter","title":"Pact vs OpenAPI: Choosing the right foundation for your API testing strategy","type":"doc","isUnderCurrentDocsTree":true},{"name":"php-beta-sso-for-enterprises","route":"/blog/php-beta-sso-for-enterprises","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:89:frontMatter","title":"PHP Beta & SSO for Enterprises","type":"doc","isUnderCurrentDocsTree":true},{"name":"php-general-availability-improved-fastapi-support-and-a-new-billing-page-experience","route":"/blog/php-general-availability-improved-fastapi-support-and-a-new-billing-page-experience","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:90:frontMatter","title":"PHP General Availability, improved FastAPI Support, and a new billing page experience","type":"doc","isUnderCurrentDocsTree":true},{"name":"php-sdks-now-available","route":"/blog/php-sdks-now-available","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:91:frontMatter","title":"PHP SDKs Now Available!","type":"doc","isUnderCurrentDocsTree":true},{"name":"picking-a-javascript-api-framework","route":"/blog/picking-a-javascript-api-framework","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:92:frontMatter","title":"Choosing the right JavaScript API framework","type":"doc","isUnderCurrentDocsTree":true},{"name":"pulumi-terraform-provider","route":"/blog/pulumi-terraform-provider","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:93:frontMatter","title":"How To Wrap Your Terraform Provider for Pulumi","type":"doc","isUnderCurrentDocsTree":true},{"name":"pydantic-vs-dataclasses","route":"/blog/pydantic-vs-dataclasses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:94:frontMatter","title":"Type Safety in Python: Pydantic vs. Data Classes vs. Annotations vs. TypedDicts","type":"doc","isUnderCurrentDocsTree":true},{"name":"python-alpha-release-pydantic-async","route":"/blog/python-alpha-release-pydantic-async","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:95:frontMatter","title":"Python Alpha Release: Pydantic & Async","type":"doc","isUnderCurrentDocsTree":true},{"name":"python-http-clients-requests-vs-httpx-vs-aiohttp","route":"/blog/python-http-clients-requests-vs-httpx-vs-aiohttp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:96:frontMatter","title":"Python HTTP Clients: Requests vs. HTTPX vs. AIOHTTP","type":"doc","isUnderCurrentDocsTree":true},{"name":"python-sdk-lazy-loading-performance","route":"/blog/python-sdk-lazy-loading-performance","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:97:frontMatter","title":"Python SDK Lazy Loading: 7.5x Faster Initialization, 80% Less Memory Use","type":"doc","isUnderCurrentDocsTree":true},{"name":"react-embeds","route":"/blog/react-embeds","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:98:frontMatter","title":"React Embeds","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-contract-testing","route":"/blog/release-contract-testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:99:frontMatter","title":"Introducing: API contract test generation","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-custom-code-regions","route":"/blog/release-custom-code-regions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:100:frontMatter","title":"Custom code regions: SDK customization without limits","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-java-ga","route":"/blog/release-java-ga","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:101:frontMatter","title":"Generally Available: Java","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-jsonl-support","route":"/blog/release-jsonl-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:102:frontMatter","title":"Native JSONL support in your SDKs","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-model-context-protocol","route":"/blog/release-model-context-protocol","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:103:frontMatter","title":"Model Context Protocol: TypeScript SDKs for the Agentic AI ecosystem","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-oss-arazzo-parser","route":"/blog/release-oss-arazzo-parser","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:104:frontMatter","title":"OSS Release: Arazzo Parser","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-php","route":"/blog/release-php","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:105:frontMatter","title":"Type-Safe PHP Generation","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-php-ga","route":"/blog/release-php-ga","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:106:frontMatter","title":"PHP is now generally available","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-postman-generator","route":"/blog/release-postman-generator","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:107:frontMatter","title":"Alpha Release: Postman Generator","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-python","route":"/blog/release-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:108:frontMatter","title":"Python Generation with Async & Pydantic Support","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-react-hooks","route":"/blog/release-react-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:109:frontMatter","title":"React Hooks: TypeScript SDKs with TanStack React Query Support","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-sdk-docs","route":"/blog/release-sdk-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:110:frontMatter","title":"Code as Docs Integration: SDKs embedded in your API reference","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-sdk-hooks","route":"/blog/release-sdk-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:111:frontMatter","title":"SDK Hooks: Safely add custom logic to your SDKs","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-sdk-sandboxes","route":"/blog/release-sdk-sandboxes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:112:frontMatter","title":"One-Click SDK Testing & Experimentation with SDK Sandboxes","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-sdk-testing","route":"/blog/release-sdk-testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:113:frontMatter","title":"Introducing comprehensive SDK Testing","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-speakeasy-docs","route":"/blog/release-speakeasy-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:114:frontMatter","title":"Speakeasy Docs: the documentation your API deserves","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-speakeasy-suggest","route":"/blog/release-speakeasy-suggest","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:115:frontMatter","title":"Introducing Speakeasy Suggest - Automatic OpenAPI Spec Maintenance","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-terraform-v2","route":"/blog/release-terraform-v2","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:116:frontMatter","title":"Release: Terraform v2","type":"doc","isUnderCurrentDocsTree":true},{"name":"release-webhooks-support","route":"/blog/release-webhooks-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:117:frontMatter","title":"Speakeasy SDK generation now supports webhooks","type":"doc","isUnderCurrentDocsTree":true},{"name":"replay-requests","route":"/blog/replay-requests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:118:frontMatter","title":"Replay Requests","type":"doc","isUnderCurrentDocsTree":true},{"name":"request-response-john-kodumal","route":"/blog/request-response-john-kodumal","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:119:frontMatter","title":"Request // Response Episode 1: Separating Deployment from Release","type":"doc","isUnderCurrentDocsTree":true},{"name":"request-response-ken-rose","route":"/blog/request-response-ken-rose","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:120:frontMatter","title":"Request // Response Episode 3: Anthropic MCP, GraphQL vs REST, and LLM API strategies","type":"doc","isUnderCurrentDocsTree":true},{"name":"request-response-robert-ross","route":"/blog/request-response-robert-ross","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:121:frontMatter","title":"Request // Response Episode 2: coding on airplanes, and the true signal of good DevEx","type":"doc","isUnderCurrentDocsTree":true},{"name":"request-response-sinan-eren","route":"/blog/request-response-sinan-eren","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:122:frontMatter","title":"Request // Response Episode 4: API Security, LLMs, and Internal Developer Tools","type":"doc","isUnderCurrentDocsTree":true},{"name":"rise-of-developer-infrastructure","route":"/blog/rise-of-developer-infrastructure","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:123:frontMatter","title":"The Rise of Developer Infrastructure","type":"doc","isUnderCurrentDocsTree":true},{"name":"rss.xml","route":"/blog/rss.xml","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:124:frontMatter","title":"Rss.xml","type":"doc","isUnderCurrentDocsTree":true},{"name":"rust-aws-api-usage-visualization","route":"/blog/rust-aws-api-usage-visualization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:125:frontMatter","title":"Rust, AWS & API Usage Visualization","type":"doc","isUnderCurrentDocsTree":true},{"name":"sandbox-instant-sdk-preview","route":"/blog/sandbox-instant-sdk-preview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:126:frontMatter","title":"Instantly Preview SDKs from your OpenAPI Spec","type":"doc","isUnderCurrentDocsTree":true},{"name":"sass-vs-css-modules-vs-css-in-js","route":"/blog/sass-vs-css-modules-vs-css-in-js","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:127:frontMatter","title":"SASS vs CSS Modules vs CSS-in-JS: How to Choose?","type":"doc","isUnderCurrentDocsTree":true},{"name":"sdk-and-terraform-generation-improvements","route":"/blog/sdk-and-terraform-generation-improvements","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:128:frontMatter","title":"SDK and Terraform Generation Improvements","type":"doc","isUnderCurrentDocsTree":true},{"name":"sdk-best-practices","route":"/blog/sdk-best-practices","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:129:frontMatter","title":"SDK Best Practices","type":"doc","isUnderCurrentDocsTree":true},{"name":"sdk-docs-in-beta-a-2024-sneak-peek","route":"/blog/sdk-docs-in-beta-a-2024-sneak-peek","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:130:frontMatter","title":"SDK Docs in Beta & a 2024 Sneak Peek","type":"doc","isUnderCurrentDocsTree":true},{"name":"sdk-hooks-openapi-reference-more","route":"/blog/sdk-hooks-openapi-reference-more","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:131:frontMatter","title":"SDK hooks, OpenAPI Reference & more!","type":"doc","isUnderCurrentDocsTree":true},{"name":"sdks-and-our-march-of-progress","route":"/blog/sdks-and-our-march-of-progress","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:132:frontMatter","title":"SDKs and Our March of Progress","type":"doc","isUnderCurrentDocsTree":true},{"name":"seamlessly-managed-sdk-versions","route":"/blog/seamlessly-managed-sdk-versions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:133:frontMatter","title":"Seamlessly Managed SDK Versions","type":"doc","isUnderCurrentDocsTree":true},{"name":"self-serve-sdk-creation-pipeline-alpha","route":"/blog/self-serve-sdk-creation-pipeline-alpha","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:134:frontMatter","title":"Self-Serve SDK Creation Pipeline [Alpha]","type":"doc","isUnderCurrentDocsTree":true},{"name":"sensitive-data-masking","route":"/blog/sensitive-data-masking","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:135:frontMatter","title":"Sensitive Data Masking","type":"doc","isUnderCurrentDocsTree":true},{"name":"snippetai-for-your-api-documentation","route":"/blog/snippetai-for-your-api-documentation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:136:frontMatter","title":"SnippetAI for your API documentation","type":"doc","isUnderCurrentDocsTree":true},{"name":"speakeasy-branding-process","route":"/blog/speakeasy-branding-process","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:137:frontMatter","title":"Speakeasy Branding Process: How We Decided on Look, Feel, Logo, & a Mascot","type":"doc","isUnderCurrentDocsTree":true},{"name":"speakeasy-is-now-officially-soc-2-compliant","route":"/blog/speakeasy-is-now-officially-soc-2-compliant","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:138:frontMatter","title":"Speakeasy is now officially SOC 2 compliant","type":"doc","isUnderCurrentDocsTree":true},{"name":"speakeasy-vs-apimatic","route":"/blog/speakeasy-vs-apimatic","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:139:frontMatter","title":"In Depth: Speakeasy vs APIMatic","type":"doc","isUnderCurrentDocsTree":true},{"name":"speakeasy-vs-fern","route":"/blog/speakeasy-vs-fern","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:140:frontMatter","title":"In depth: Speakeasy vs Fern","type":"doc","isUnderCurrentDocsTree":true},{"name":"speakeasy-vs-liblab","route":"/blog/speakeasy-vs-liblab","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:141:frontMatter","title":"In depth: Speakeasy vs liblab","type":"doc","isUnderCurrentDocsTree":true},{"name":"speakeasy-vs-openapi-generator","route":"/blog/speakeasy-vs-openapi-generator","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:142:frontMatter","title":"Speakeasy vs OpenAPI/Swagger Generator","type":"doc","isUnderCurrentDocsTree":true},{"name":"speakeasy-vs-stainless","route":"/blog/speakeasy-vs-stainless","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:143:frontMatter","title":"In Depth: Speakeasy vs Stainless","type":"doc","isUnderCurrentDocsTree":true},{"name":"standalone-functions","route":"/blog/standalone-functions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:144:frontMatter","title":"Lean SDKs with Standalone Functions","type":"doc","isUnderCurrentDocsTree":true},{"name":"streamlined-sdk-testing-ai-ready-apis-with-mcp-server-generation","route":"/blog/streamlined-sdk-testing-ai-ready-apis-with-mcp-server-generation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:145:frontMatter","title":"Streamlined SDK Testing & AI-Ready APIs with MCP Server Generation","type":"doc","isUnderCurrentDocsTree":true},{"name":"tags-best-practices-in-openapi","route":"/blog/tags-best-practices-in-openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:146:frontMatter","title":"Tags Best Practices in OpenAPI","type":"doc","isUnderCurrentDocsTree":true},{"name":"terraform-enhancing-validation","route":"/blog/terraform-enhancing-validation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:147:frontMatter","title":"Enhancing Terraform Providers with Configuration Validation","type":"doc","isUnderCurrentDocsTree":true},{"name":"terraform-generation-alpha","route":"/blog/terraform-generation-alpha","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:148:frontMatter","title":"Terraform Generation Alpha","type":"doc","isUnderCurrentDocsTree":true},{"name":"terraform-v2-cli-upgrade","route":"/blog/terraform-v2-cli-upgrade","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:149:frontMatter","title":"Terraform v2 & CLI Upgrade","type":"doc","isUnderCurrentDocsTree":true},{"name":"test-suite-generation-early-access","route":"/blog/test-suite-generation-early-access","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:150:frontMatter","title":"Test Suite Generation Early Access","type":"doc","isUnderCurrentDocsTree":true},{"name":"the-rest-template-project","route":"/blog/the-rest-template-project","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:151:frontMatter","title":"The REST Template Project","type":"doc","isUnderCurrentDocsTree":true},{"name":"type-safe-vs-type-faith","route":"/blog/type-safe-vs-type-faith","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:152:frontMatter","title":"Type Faith vs Type Safe","type":"doc","isUnderCurrentDocsTree":true},{"name":"ui-enhancements-deepobject-query-support-for-terraform","route":"/blog/ui-enhancements-deepobject-query-support-for-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:153:frontMatter","title":"UI Enhancements & deepObject Query Support for Terraform","type":"doc","isUnderCurrentDocsTree":true},{"name":"unity-and-c-now-available-as-generation-targets","route":"/blog/unity-and-c-now-available-as-generation-targets","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:154:frontMatter","title":"Unity and C# now available as generation targets!","type":"doc","isUnderCurrentDocsTree":true},{"name":"vitest-vs-jest","route":"/blog/vitest-vs-jest","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:155:frontMatter","title":"Vitest vs Jest","type":"doc","isUnderCurrentDocsTree":true},{"name":"webhook-security","route":"/blog/webhook-security","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:156:frontMatter","title":"The double standard of webhook security and API security","type":"doc","isUnderCurrentDocsTree":true},{"name":"why-an-api-platform-is-important","route":"/blog/why-an-api-platform-is-important","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:157:frontMatter","title":"API Experts - Why an API Platform is important","type":"doc","isUnderCurrentDocsTree":true},{"name":"why-work-at-speakeasy","route":"/blog/why-work-at-speakeasy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:158:frontMatter","title":"Why work on API developer experience?","type":"doc","isUnderCurrentDocsTree":true},{"name":"windows-support-quickstart-and-a-v1-sunset","route":"/blog/windows-support-quickstart-and-a-v1-sunset","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:159:frontMatter","title":"Windows Support, Quickstart, and a V1 Sunset","type":"doc","isUnderCurrentDocsTree":true},{"name":"writing-zod-code-that-minifies","route":"/blog/writing-zod-code-that-minifies","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:160:frontMatter","title":"Writing Zod code that minifies","type":"doc","isUnderCurrentDocsTree":true}],"activePath":[{"name":"blog","route":"/blog","children":[{"name":"index","route":"/blog","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:1:frontMatter","title":"Blog | Speakeasy","type":"doc"},{"name":"5-potential-use-cases-for-Arazzo","route":"/blog/5-potential-use-cases-for-Arazzo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:2:frontMatter","title":"5 potential use cases for Arazzo","type":"doc"},{"name":"a-copilot-for-your-api-spec-and-pagination","route":"/blog/a-copilot-for-your-api-spec-and-pagination","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:3:frontMatter","title":"A Copilot for your API spec and Pagination","type":"doc"},{"name":"a-dev-portal-on-demand","route":"/blog/a-dev-portal-on-demand","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:4:frontMatter","title":"A Dev Portal on Demand","type":"doc"},{"name":"a-monorepo-for-your-sdks","route":"/blog/a-monorepo-for-your-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:5:frontMatter","title":"A MonoRepo For Your SDKs","type":"doc"},{"name":"add-prompts-to-your-mcp-server","route":"/blog/add-prompts-to-your-mcp-server","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:6:frontMatter","title":"Add prompts to your MCP server","type":"doc"},{"name":"announcing-easysdk-generator","route":"/blog/announcing-easysdk-generator","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:7:frontMatter","title":"Announcing: EasySDK Generator","type":"doc"},{"name":"api-auth-guide","route":"/blog/api-auth-guide","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:8:frontMatter","title":"Guide to API Auth & A Novel Approach","type":"doc"},{"name":"api-change-detection-open-enums","route":"/blog/api-change-detection-open-enums","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:9:frontMatter","title":"API Change Detection & Open Enums","type":"doc"},{"name":"api-design","route":"/blog/api-design","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:10:frontMatter","title":"Designing your API: Find the RESTful sweet spot","type":"doc"},{"name":"api-experts-akshat-agrawal","route":"/blog/api-experts-akshat-agrawal","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:11:frontMatter","title":"API Experts - APIs That Build APIs","type":"doc"},{"name":"api-experts-clarence-chio","route":"/blog/api-experts-clarence-chio","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:12:frontMatter","title":"API Experts - APIs to Fight Fraud","type":"doc"},{"name":"api-experts-jack-reed","route":"/blog/api-experts-jack-reed","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:13:frontMatter","title":"API Experts - APIs that Move Money","type":"doc"},{"name":"api-experts-mathias-vagni","route":"/blog/api-experts-mathias-vagni","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:14:frontMatter","title":"API Experts - APIs to Support your Customers","type":"doc"},{"name":"api-key-management","route":"/blog/api-key-management","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:15:frontMatter","title":"API Key Management","type":"doc"},{"name":"api-landscape","route":"/blog/api-landscape","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:16:frontMatter","title":"The Speakeasy API Landscape","type":"doc"},{"name":"api-linting-postman-generation","route":"/blog/api-linting-postman-generation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:17:frontMatter","title":"API Linting & Postman Generation","type":"doc"},{"name":"api-ops-usage-monitoring","route":"/blog/api-ops-usage-monitoring","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:18:frontMatter","title":"API Ops - The Difficulties In Monitoring API Usage","type":"doc"},{"name":"apis-for-global-shipping","route":"/blog/apis-for-global-shipping","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:19:frontMatter","title":"API Experts - Shipping APIs for Global Shipping","type":"doc"},{"name":"apis-vs-sdks-difference","route":"/blog/apis-vs-sdks-difference","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:20:frontMatter","title":"APIs vs. SDKs: Key Differences, Use Cases, and Best Practices","type":"doc"},{"name":"auth-for-embedded-react-components","route":"/blog/auth-for-embedded-react-components","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:21:frontMatter","title":"How to Handle Auth for Embedded React Components","type":"doc"},{"name":"automate-oauth-flows-streamline-publishing","route":"/blog/automate-oauth-flows-streamline-publishing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:22:frontMatter","title":"Automate your OAuth flows and streamline publishing","type":"doc"},{"name":"automated-code-samples-overlay-management-in-speakeasy-studio","route":"/blog/automated-code-samples-overlay-management-in-speakeasy-studio","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:23:frontMatter","title":"Automated Code Samples & Overlay Management in Speakeasy Studio!","type":"doc"},{"name":"build-a-mcp-server-tutorial","route":"/blog/build-a-mcp-server-tutorial","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:24:frontMatter","title":"Building a Model Context Protocol (MCP) server for Discord","type":"doc"},{"name":"build-custom-workflows-sneak-peak","route":"/blog/build-custom-workflows-sneak-peak","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:25:frontMatter","title":"Build Custom Workflows - Sneak Peak!","type":"doc"},{"name":"build-terraform-providers","route":"/blog/build-terraform-providers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:26:frontMatter","title":"Building a SaaS API? Don't Forget Your Terraform Provider","type":"doc"},{"name":"building-php-sdks","route":"/blog/building-php-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:27:frontMatter","title":"How to Build an SDK in PHP","type":"doc"},{"name":"c-general-availability-our-ai-enhanced-cli","route":"/blog/c-general-availability-our-ai-enhanced-cli","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:28:frontMatter","title":"C# General Availability & our AI-enhanced CLI","type":"doc"},{"name":"choosing-a-docs-vendor","route":"/blog/choosing-a-docs-vendor","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:29:frontMatter","title":"Choosing a docs vendor: Mintlify vs Scalar vs Bump vs ReadMe vs Redocly","type":"doc"},{"name":"choosing-your-framework-python","route":"/blog/choosing-your-framework-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:30:frontMatter","title":"Choosing your Python REST API framework","type":"doc"},{"name":"contract-testing-with-openapi","route":"/blog/contract-testing-with-openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:31:frontMatter","title":"Contract testing with OpenAPI","type":"doc"},{"name":"create-a-terraform-provider-a-guide-for-beginners","route":"/blog/create-a-terraform-provider-a-guide-for-beginners","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:32:frontMatter","title":"How To Create a Terraform Provider — a Guide for Absolute Beginners","type":"doc"},{"name":"custom-code-regions-an-overlay-playground","route":"/blog/custom-code-regions-an-overlay-playground","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:33:frontMatter","title":"Custom code regions & an Overlay playground!","type":"doc"},{"name":"custom-type-support-in-terraform","route":"/blog/custom-type-support-in-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:34:frontMatter","title":"Custom type support in Terraform","type":"doc"},{"name":"customisable-imports-openapi-overlays-and-terraform-generation-improvements","route":"/blog/customisable-imports-openapi-overlays-and-terraform-generation-improvements","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:35:frontMatter","title":"Customisable Imports, OpenAPI Overlays, and Terraform generation improvements!","type":"doc"},{"name":"definitive-guide-to-devex-portals","route":"/blog/definitive-guide-to-devex-portals","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:36:frontMatter","title":"Definitive Guide to API DevEx Portals","type":"doc"},{"name":"design-responses","route":"/blog/design-responses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:37:frontMatter","title":"Designing REST APIs: Responses Your Users Expect","type":"doc"},{"name":"devex-portals-as-a-service","route":"/blog/devex-portals-as-a-service","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:38:frontMatter","title":"DevEx portals as a service","type":"doc"},{"name":"dynamic-dev-portals-with-speakeasy-components","route":"/blog/dynamic-dev-portals-with-speakeasy-components","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:39:frontMatter","title":"Dynamic Dev Portals with Speakeasy Components","type":"doc"},{"name":"e2e-testing-arazzo","route":"/blog/e2e-testing-arazzo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:40:frontMatter","title":"End-to-end API testing with Arazzo, TypeScript, and Deno","type":"doc"},{"name":"early-access-for-universal-typescript-sdk-and-sdk-docs","route":"/blog/early-access-for-universal-typescript-sdk-and-sdk-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:41:frontMatter","title":"Early Access for Universal Typescript SDK and SDK Docs","type":"doc"},{"name":"easy-validation-for-openapi","route":"/blog/easy-validation-for-openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:42:frontMatter","title":"Easy Validation For OpenAPI","type":"doc"},{"name":"easytemplate-release","route":"/blog/easytemplate-release","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:43:frontMatter","title":"EasyTemplate OSS Release: Templating Superpowers for Go","type":"doc"},{"name":"enforcing-api-consistency","route":"/blog/enforcing-api-consistency","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:44:frontMatter","title":"Enforcing API consistency","type":"doc"},{"name":"fundraising-series-a","route":"/blog/fundraising-series-a","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:45:frontMatter","title":"Speakeasy's $15M Series A","type":"doc"},{"name":"hathora-gaming-devex","route":"/blog/hathora-gaming-devex","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:46:frontMatter","title":"Game Dev & The Rise of Developer Experience","type":"doc"},{"name":"hiring-a-founding-team","route":"/blog/hiring-a-founding-team","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:47:frontMatter","title":"A New Approach to Hiring A Founding Team","type":"doc"},{"name":"how-to-build-sdks","route":"/blog/how-to-build-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:48:frontMatter","title":"How to Build SDKs for Your API: Handwritten, OpenAPI Generator, or Speakeasy?","type":"doc"},{"name":"how-to-build-terraform-providers","route":"/blog/how-to-build-terraform-providers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:49:frontMatter","title":"How to Generate Terraform Providers","type":"doc"},{"name":"how-to-create-a-custom-python-sdk","route":"/blog/how-to-create-a-custom-python-sdk","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:50:frontMatter","title":"How To Build A Best In Class Python SDK","type":"doc"},{"name":"how-to-generate-a-mock-server","route":"/blog/how-to-generate-a-mock-server","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:51:frontMatter","title":"How to generate a mock server to test SDKs","type":"doc"},{"name":"how-to-set-operationid","route":"/blog/how-to-set-operationid","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:52:frontMatter","title":"OpenAPI Tips - How to set operationId","type":"doc"},{"name":"how-we-built-cli","route":"/blog/how-we-built-cli","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:53:frontMatter","title":"Why and How we invested in building a best in class CLI","type":"doc"},{"name":"how-we-built-universal-ts","route":"/blog/how-we-built-universal-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:54:frontMatter","title":"How We Built It - Universal Typescript","type":"doc"},{"name":"improved-devex-with-flattened-sdks","route":"/blog/improved-devex-with-flattened-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:55:frontMatter","title":"Improved DevEX with Flattened SDKs","type":"doc"},{"name":"integrate-with-your-favorite-docs-provider","route":"/blog/integrate-with-your-favorite-docs-provider","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:56:frontMatter","title":"Integrate with Your Favorite Docs Provider!","type":"doc"},{"name":"internal-sdks","route":"/blog/internal-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:57:frontMatter","title":"Building SDKs for internal APIs: How to Boost developer velocity","type":"doc"},{"name":"introducing-speakeasy","route":"/blog/introducing-speakeasy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:58:frontMatter","title":"Speakeasy's $11M Raise","type":"doc"},{"name":"introducing-universal-ts","route":"/blog/introducing-universal-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:59:frontMatter","title":"Introducing Universal TypeScript: A TS SDK your users will love","type":"doc"},{"name":"java-general-availability-and-managed-oauth-support","route":"/blog/java-general-availability-and-managed-oauth-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:60:frontMatter","title":"Java General Availability and managed OAuth support","type":"doc"},{"name":"java-sdks-telemetry","route":"/blog/java-sdks-telemetry","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:61:frontMatter","title":"Java SDKs & Telemetry","type":"doc"},{"name":"label-based-versioning-openapi-transformations-and-overlay-insights","route":"/blog/label-based-versioning-openapi-transformations-and-overlay-insights","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:62:frontMatter","title":"Label-Based Versioning, OpenAPI Transformations, and Overlay Insights","type":"doc"},{"name":"langchain-vs-haystack-api-tools","route":"/blog/langchain-vs-haystack-api-tools","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:63:frontMatter","title":"Building an AI agent with OpenAPI: LangChain vs. Haystack","type":"doc"},{"name":"last-changelog-of-the-year-looking-ahead-and-a-thank-you","route":"/blog/last-changelog-of-the-year-looking-ahead-and-a-thank-you","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:64:frontMatter","title":"Last changelog of the year, looking ahead, and a thank you!","type":"doc"},{"name":"launch-week-0-round-up-webhooks-react-query-support-more","route":"/blog/launch-week-0-round-up-webhooks-react-query-support-more","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:65:frontMatter","title":"Launch week 0 round up: webhooks, react query support & more!","type":"doc"},{"name":"lean-typescript-sdks-for-the-browser","route":"/blog/lean-typescript-sdks-for-the-browser","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:66:frontMatter","title":"Lean TypeScript SDKs for the browser","type":"doc"},{"name":"loom-for-remote-collaboration","route":"/blog/loom-for-remote-collaboration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:67:frontMatter","title":"Using Loom for Remote Collaboration","type":"doc"},{"name":"mintlify-integration-plan-validators-and-python-async-beta","route":"/blog/mintlify-integration-plan-validators-and-python-async-beta","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:68:frontMatter","title":"Mintlify Integration, Plan Validators, and Python Async Beta","type":"doc"},{"name":"more-apis-less-complexity","route":"/blog/more-apis-less-complexity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:69:frontMatter","title":"More APIs, Less Complexity","type":"doc"},{"name":"native-jsonl-support-in-your-sdks","route":"/blog/native-jsonl-support-in-your-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:70:frontMatter","title":"Native JSONL support in your SDKs","type":"doc"},{"name":"nivo-vs-recharts","route":"/blog/nivo-vs-recharts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:71:frontMatter","title":"Nivo vs Recharts - Which should you use?","type":"doc"},{"name":"on-demand-publishing-pre-releases","route":"/blog/on-demand-publishing-pre-releases","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:72:frontMatter","title":"On Demand Publishing & Pre-Releases","type":"doc"},{"name":"one-click-request-sharing","route":"/blog/one-click-request-sharing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:73:frontMatter","title":"One-click Request Sharing","type":"doc"},{"name":"open-enums","route":"/blog/open-enums","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:74:frontMatter","title":"Evolving enums for evolving APIs","type":"doc"},{"name":"open-source-pledge-2024","route":"/blog/open-source-pledge-2024","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:75:frontMatter","title":"$$40,000 for OSS maintainers","type":"doc"},{"name":"openapi-has-flaws","route":"/blog/openapi-has-flaws","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:76:frontMatter","title":"OpenAPI has flaws, so what?","type":"doc"},{"name":"openapi-reference-guide","route":"/blog/openapi-reference-guide","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:77:frontMatter","title":"Everything You Need to Know About OpenAPI","type":"doc"},{"name":"openapi-servers","route":"/blog/openapi-servers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:78:frontMatter","title":"Defining OpenAPI Servers - The Where To Your API's How","type":"doc"},{"name":"openapi-spec-drift-detection","route":"/blog/openapi-spec-drift-detection","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:79:frontMatter","title":"OpenAPI Spec Drift Detection","type":"doc"},{"name":"openapi-studio-laravel-integration-and-what-in-zod-s-name","route":"/blog/openapi-studio-laravel-integration-and-what-in-zod-s-name","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:80:frontMatter","title":"OpenAPI Studio, Laravel Integration, and 'what in Zod's name?'","type":"doc"},{"name":"openapi-tips-auth","route":"/blog/openapi-tips-auth","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:81:frontMatter","title":"OpenAPI Tips - How to Handle Auth","type":"doc"},{"name":"openapi-tips-data-type-formats","route":"/blog/openapi-tips-data-type-formats","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:82:frontMatter","title":"OpenAPI tips - Data types and formats","type":"doc"},{"name":"openapi-tips-oneof-allof-anyof","route":"/blog/openapi-tips-oneof-allof-anyof","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:83:frontMatter","title":"OneOf, AllOf, AnyOf Oh my! How to define union types in OpenAPI","type":"doc"},{"name":"openapi-tips-query-parameters-serialization","route":"/blog/openapi-tips-query-parameters-serialization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:84:frontMatter","title":"OpenAPI Tips - Query Parameters & Serialization","type":"doc"},{"name":"openapi-tips-webhooks-callbacks","route":"/blog/openapi-tips-webhooks-callbacks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:85:frontMatter","title":"Webhooks & Callbacks in OpenAPI/Swagger","type":"doc"},{"name":"openapi-webhook-support","route":"/blog/openapi-webhook-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:86:frontMatter","title":"OpenAPI Webhook Support","type":"doc"},{"name":"our-series-a-fundraise","route":"/blog/our-series-a-fundraise","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:87:frontMatter","title":"Our Series A fundraise","type":"doc"},{"name":"pact-vs-openapi","route":"/blog/pact-vs-openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:88:frontMatter","title":"Pact vs OpenAPI: Choosing the right foundation for your API testing strategy","type":"doc"},{"name":"php-beta-sso-for-enterprises","route":"/blog/php-beta-sso-for-enterprises","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:89:frontMatter","title":"PHP Beta & SSO for Enterprises","type":"doc"},{"name":"php-general-availability-improved-fastapi-support-and-a-new-billing-page-experience","route":"/blog/php-general-availability-improved-fastapi-support-and-a-new-billing-page-experience","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:90:frontMatter","title":"PHP General Availability, improved FastAPI Support, and a new billing page experience","type":"doc"},{"name":"php-sdks-now-available","route":"/blog/php-sdks-now-available","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:91:frontMatter","title":"PHP SDKs Now Available!","type":"doc"},{"name":"picking-a-javascript-api-framework","route":"/blog/picking-a-javascript-api-framework","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:92:frontMatter","title":"Choosing the right JavaScript API framework","type":"doc"},{"name":"pulumi-terraform-provider","route":"/blog/pulumi-terraform-provider","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:93:frontMatter","title":"How To Wrap Your Terraform Provider for Pulumi","type":"doc"},{"name":"pydantic-vs-dataclasses","route":"/blog/pydantic-vs-dataclasses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:94:frontMatter","title":"Type Safety in Python: Pydantic vs. Data Classes vs. Annotations vs. TypedDicts","type":"doc"},{"name":"python-alpha-release-pydantic-async","route":"/blog/python-alpha-release-pydantic-async","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:95:frontMatter","title":"Python Alpha Release: Pydantic & Async","type":"doc"},{"name":"python-http-clients-requests-vs-httpx-vs-aiohttp","route":"/blog/python-http-clients-requests-vs-httpx-vs-aiohttp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:96:frontMatter","title":"Python HTTP Clients: Requests vs. HTTPX vs. AIOHTTP","type":"doc"},{"name":"python-sdk-lazy-loading-performance","route":"/blog/python-sdk-lazy-loading-performance","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:97:frontMatter","title":"Python SDK Lazy Loading: 7.5x Faster Initialization, 80% Less Memory Use","type":"doc"},{"name":"react-embeds","route":"/blog/react-embeds","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:98:frontMatter","title":"React Embeds","type":"doc"},{"name":"release-contract-testing","route":"/blog/release-contract-testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:99:frontMatter","title":"Introducing: API contract test generation","type":"doc"},{"name":"release-custom-code-regions","route":"/blog/release-custom-code-regions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:100:frontMatter","title":"Custom code regions: SDK customization without limits","type":"doc"},{"name":"release-java-ga","route":"/blog/release-java-ga","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:101:frontMatter","title":"Generally Available: Java","type":"doc"},{"name":"release-jsonl-support","route":"/blog/release-jsonl-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:102:frontMatter","title":"Native JSONL support in your SDKs","type":"doc"},{"name":"release-model-context-protocol","route":"/blog/release-model-context-protocol","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:103:frontMatter","title":"Model Context Protocol: TypeScript SDKs for the Agentic AI ecosystem","type":"doc"},{"name":"release-oss-arazzo-parser","route":"/blog/release-oss-arazzo-parser","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:104:frontMatter","title":"OSS Release: Arazzo Parser","type":"doc"},{"name":"release-php","route":"/blog/release-php","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:105:frontMatter","title":"Type-Safe PHP Generation","type":"doc"},{"name":"release-php-ga","route":"/blog/release-php-ga","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:106:frontMatter","title":"PHP is now generally available","type":"doc"},{"name":"release-postman-generator","route":"/blog/release-postman-generator","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:107:frontMatter","title":"Alpha Release: Postman Generator","type":"doc"},{"name":"release-python","route":"/blog/release-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:108:frontMatter","title":"Python Generation with Async & Pydantic Support","type":"doc"},{"name":"release-react-hooks","route":"/blog/release-react-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:109:frontMatter","title":"React Hooks: TypeScript SDKs with TanStack React Query Support","type":"doc"},{"name":"release-sdk-docs","route":"/blog/release-sdk-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:110:frontMatter","title":"Code as Docs Integration: SDKs embedded in your API reference","type":"doc"},{"name":"release-sdk-hooks","route":"/blog/release-sdk-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:111:frontMatter","title":"SDK Hooks: Safely add custom logic to your SDKs","type":"doc"},{"name":"release-sdk-sandboxes","route":"/blog/release-sdk-sandboxes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:112:frontMatter","title":"One-Click SDK Testing & Experimentation with SDK Sandboxes","type":"doc"},{"name":"release-sdk-testing","route":"/blog/release-sdk-testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:113:frontMatter","title":"Introducing comprehensive SDK Testing","type":"doc"},{"name":"release-speakeasy-docs","route":"/blog/release-speakeasy-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:114:frontMatter","title":"Speakeasy Docs: the documentation your API deserves","type":"doc"},{"name":"release-speakeasy-suggest","route":"/blog/release-speakeasy-suggest","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:115:frontMatter","title":"Introducing Speakeasy Suggest - Automatic OpenAPI Spec Maintenance","type":"doc"},{"name":"release-terraform-v2","route":"/blog/release-terraform-v2","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:116:frontMatter","title":"Release: Terraform v2","type":"doc"},{"name":"release-webhooks-support","route":"/blog/release-webhooks-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:117:frontMatter","title":"Speakeasy SDK generation now supports webhooks","type":"doc"},{"name":"replay-requests","route":"/blog/replay-requests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:118:frontMatter","title":"Replay Requests","type":"doc"},{"name":"request-response-john-kodumal","route":"/blog/request-response-john-kodumal","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:119:frontMatter","title":"Request // Response Episode 1: Separating Deployment from Release","type":"doc"},{"name":"request-response-ken-rose","route":"/blog/request-response-ken-rose","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:120:frontMatter","title":"Request // Response Episode 3: Anthropic MCP, GraphQL vs REST, and LLM API strategies","type":"doc"},{"name":"request-response-robert-ross","route":"/blog/request-response-robert-ross","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:121:frontMatter","title":"Request // Response Episode 2: coding on airplanes, and the true signal of good DevEx","type":"doc"},{"name":"request-response-sinan-eren","route":"/blog/request-response-sinan-eren","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:122:frontMatter","title":"Request // Response Episode 4: API Security, LLMs, and Internal Developer Tools","type":"doc"},{"name":"rise-of-developer-infrastructure","route":"/blog/rise-of-developer-infrastructure","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:123:frontMatter","title":"The Rise of Developer Infrastructure","type":"doc"},{"name":"rss.xml","route":"/blog/rss.xml","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:124:frontMatter","title":"Rss.xml","type":"doc"},{"name":"rust-aws-api-usage-visualization","route":"/blog/rust-aws-api-usage-visualization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:125:frontMatter","title":"Rust, AWS & API Usage Visualization","type":"doc"},{"name":"sandbox-instant-sdk-preview","route":"/blog/sandbox-instant-sdk-preview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:126:frontMatter","title":"Instantly Preview SDKs from your OpenAPI Spec","type":"doc"},{"name":"sass-vs-css-modules-vs-css-in-js","route":"/blog/sass-vs-css-modules-vs-css-in-js","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:127:frontMatter","title":"SASS vs CSS Modules vs CSS-in-JS: How to Choose?","type":"doc"},{"name":"sdk-and-terraform-generation-improvements","route":"/blog/sdk-and-terraform-generation-improvements","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:128:frontMatter","title":"SDK and Terraform Generation Improvements","type":"doc"},{"name":"sdk-best-practices","route":"/blog/sdk-best-practices","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:129:frontMatter","title":"SDK Best Practices","type":"doc"},{"name":"sdk-docs-in-beta-a-2024-sneak-peek","route":"/blog/sdk-docs-in-beta-a-2024-sneak-peek","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:130:frontMatter","title":"SDK Docs in Beta & a 2024 Sneak Peek","type":"doc"},{"name":"sdk-hooks-openapi-reference-more","route":"/blog/sdk-hooks-openapi-reference-more","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:131:frontMatter","title":"SDK hooks, OpenAPI Reference & more!","type":"doc"},{"name":"sdks-and-our-march-of-progress","route":"/blog/sdks-and-our-march-of-progress","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:132:frontMatter","title":"SDKs and Our March of Progress","type":"doc"},{"name":"seamlessly-managed-sdk-versions","route":"/blog/seamlessly-managed-sdk-versions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:133:frontMatter","title":"Seamlessly Managed SDK Versions","type":"doc"},{"name":"self-serve-sdk-creation-pipeline-alpha","route":"/blog/self-serve-sdk-creation-pipeline-alpha","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:134:frontMatter","title":"Self-Serve SDK Creation Pipeline [Alpha]","type":"doc"},{"name":"sensitive-data-masking","route":"/blog/sensitive-data-masking","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:135:frontMatter","title":"Sensitive Data Masking","type":"doc"},{"name":"snippetai-for-your-api-documentation","route":"/blog/snippetai-for-your-api-documentation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:136:frontMatter","title":"SnippetAI for your API documentation","type":"doc"},{"name":"speakeasy-branding-process","route":"/blog/speakeasy-branding-process","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:137:frontMatter","title":"Speakeasy Branding Process: How We Decided on Look, Feel, Logo, & a Mascot","type":"doc"},{"name":"speakeasy-is-now-officially-soc-2-compliant","route":"/blog/speakeasy-is-now-officially-soc-2-compliant","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:138:frontMatter","title":"Speakeasy is now officially SOC 2 compliant","type":"doc"},{"name":"speakeasy-vs-apimatic","route":"/blog/speakeasy-vs-apimatic","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:139:frontMatter","title":"In Depth: Speakeasy vs APIMatic","type":"doc"},{"name":"speakeasy-vs-fern","route":"/blog/speakeasy-vs-fern","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:140:frontMatter","title":"In depth: Speakeasy vs Fern","type":"doc"},{"name":"speakeasy-vs-liblab","route":"/blog/speakeasy-vs-liblab","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:141:frontMatter","title":"In depth: Speakeasy vs liblab","type":"doc"},{"name":"speakeasy-vs-openapi-generator","route":"/blog/speakeasy-vs-openapi-generator","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:142:frontMatter","title":"Speakeasy vs OpenAPI/Swagger Generator","type":"doc"},{"name":"speakeasy-vs-stainless","route":"/blog/speakeasy-vs-stainless","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:143:frontMatter","title":"In Depth: Speakeasy vs Stainless","type":"doc"},{"name":"standalone-functions","route":"/blog/standalone-functions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:144:frontMatter","title":"Lean SDKs with Standalone Functions","type":"doc"},{"name":"streamlined-sdk-testing-ai-ready-apis-with-mcp-server-generation","route":"/blog/streamlined-sdk-testing-ai-ready-apis-with-mcp-server-generation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:145:frontMatter","title":"Streamlined SDK Testing & AI-Ready APIs with MCP Server Generation","type":"doc"},{"name":"tags-best-practices-in-openapi","route":"/blog/tags-best-practices-in-openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:146:frontMatter","title":"Tags Best Practices in OpenAPI","type":"doc"},{"name":"terraform-enhancing-validation","route":"/blog/terraform-enhancing-validation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:147:frontMatter","title":"Enhancing Terraform Providers with Configuration Validation","type":"doc"},{"name":"terraform-generation-alpha","route":"/blog/terraform-generation-alpha","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:148:frontMatter","title":"Terraform Generation Alpha","type":"doc"},{"name":"terraform-v2-cli-upgrade","route":"/blog/terraform-v2-cli-upgrade","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:149:frontMatter","title":"Terraform v2 & CLI Upgrade","type":"doc"},{"name":"test-suite-generation-early-access","route":"/blog/test-suite-generation-early-access","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:150:frontMatter","title":"Test Suite Generation Early Access","type":"doc"},{"name":"the-rest-template-project","route":"/blog/the-rest-template-project","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:151:frontMatter","title":"The REST Template Project","type":"doc"},{"name":"type-safe-vs-type-faith","route":"/blog/type-safe-vs-type-faith","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:152:frontMatter","title":"Type Faith vs Type Safe","type":"doc"},{"name":"ui-enhancements-deepobject-query-support-for-terraform","route":"/blog/ui-enhancements-deepobject-query-support-for-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:153:frontMatter","title":"UI Enhancements & deepObject Query Support for Terraform","type":"doc"},{"name":"unity-and-c-now-available-as-generation-targets","route":"/blog/unity-and-c-now-available-as-generation-targets","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:154:frontMatter","title":"Unity and C# now available as generation targets!","type":"doc"},{"name":"vitest-vs-jest","route":"/blog/vitest-vs-jest","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:155:frontMatter","title":"Vitest vs Jest","type":"doc"},{"name":"webhook-security","route":"/blog/webhook-security","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:156:frontMatter","title":"The double standard of webhook security and API security","type":"doc"},{"name":"why-an-api-platform-is-important","route":"/blog/why-an-api-platform-is-important","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:157:frontMatter","title":"API Experts - Why an API Platform is important","type":"doc"},{"name":"why-work-at-speakeasy","route":"/blog/why-work-at-speakeasy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:158:frontMatter","title":"Why work on API developer experience?","type":"doc"},{"name":"windows-support-quickstart-and-a-v1-sunset","route":"/blog/windows-support-quickstart-and-a-v1-sunset","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:159:frontMatter","title":"Windows Support, Quickstart, and a V1 Sunset","type":"doc"},{"name":"writing-zod-code-that-minifies","route":"/blog/writing-zod-code-that-minifies","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:160:frontMatter","title":"Writing Zod code that minifies","type":"doc"}],"title":"Blog","type":"page","display":"children"},"$5:0:props:activePath:0:children:139"]}],["$","div",null,{"className":"docs-layout-default docs-content blog","children":["$","$L21",null,{"value":[{"value":"How is Speakeasy different?","id":"how-is-speakeasy-different","depth":2},{"value":"Speakeasy is everything you need in one","id":"speakeasy-is-everything-you-need-in-one","depth":3},{"value":"OpenAPI-native vs OpenAPI-compatible","id":"openapi-native-vs-openapi-compatible","depth":3},{"value":"Engineering velocity and maturity","id":"engineering-velocity-and-maturity","depth":3},{"value":"Speakeasy SDKs work where you need them","id":"speakeasy-sdks-work-where-you-need-them","depth":3},{"value":"Comparing Speakeasy and Fern","id":"comparing-speakeasy-and-fern","depth":2},{"value":"SDK generation","id":"sdk-generation","depth":3},{"value":"SDK features","id":"sdk-features","depth":3},{"value":"Platform features","id":"platform-features","depth":3},{"value":"Dependencies and SBOM (Software Bill of Materials)","id":"dependencies-and-sbom-software-bill-of-materials","depth":3},{"value":"Enterprise support","id":"enterprise-support","depth":3},{"value":"Pricing","id":"pricing","depth":3},{"value":"Fern and Speakeasy walkthrough","id":"fern-and-speakeasy-walkthrough","depth":2},{"value":"Creating SDKs","id":"creating-sdks","depth":2},{"value":"Fern quickstart","id":"fern-quickstart","depth":3},{"value":"Speakeasy quickstart","id":"speakeasy-quickstart","depth":3},{"value":"Comparing TypeScript SDK generation with Fern and Speakeasy","id":"comparing-typescript-sdk-generation-with-fern-and-speakeasy","depth":2},{"value":"SDK structure","id":"sdk-structure","depth":3},{"value":"Example SDK method","id":"example-sdk-method","depth":3},{"value":"Type safety","id":"type-safety","depth":3},{"value":"File streaming","id":"file-streaming","depth":3},{"value":"React Hooks","id":"react-hooks","depth":3},{"value":"Auto-pagination","id":"auto-pagination","depth":4},{"value":"Webhooks support","id":"webhooks-support","depth":3},{"value":"OAuth client credentials handling","id":"oauth-client-credentials-handling","depth":3},{"value":"Fern-generated SDK case study: Cohere TypeScript","id":"fern-generated-sdk-case-study-cohere-typescript","depth":2},{"value":"SDK structure","id":"sdk-structure-1","depth":3},{"value":"Data validation libraries","id":"data-validation-libraries","depth":3},{"value":"Documentation","id":"documentation","depth":3},{"value":"Readability","id":"readability","depth":3},{"value":"Open enums","id":"open-enums","depth":3},{"value":"SDK and bundle size","id":"sdk-and-bundle-size","depth":2},{"value":"Creating bundles","id":"creating-bundles","depth":3},{"value":"Bundle size comparison","id":"bundle-size-comparison","depth":3},{"value":"Analyzing bundle sizes","id":"analyzing-bundle-sizes","depth":3},{"value":"Bundling for the browser","id":"bundling-for-the-browser","depth":3},{"value":"Summary","id":"summary","depth":2}],"children":[["$","$L22",null,{}],["$","$L23",null,{"metadata":{"title":"In depth: Speakeasy vs Fern","filePath":"src/content/blog/speakeasy-vs-fern/index.mdx","description":"Want to know how Speakeasy and Fern compare? The summary is that Speakeasy supports more language targets for SDK generation, and has a deeper platform for managing API creation. Read on for the details.","image":"/assets/speakeasy-vs-fern.png","date":"2025-02-01","authors":[{"name":"Nolan Sullivan"},{"image_url":"/assets/author-headshots/nolan.jpeg"}],"tags":null,"hidden":true,"featured_image":"/assets/speakeasy-vs-fern.png","timestamp":1746647952000},"bottomContent":"$undefined","children":[["$","div",null,{"id":"nextra-skip-nav"}],["$","main",null,{"data-pagefind-body":true,"children":[["$","$L24",null,{"content":{"activeType":"doc","activeIndex":459,"activeThemeContext":{"breadcrumb":true,"collapsed":"$undefined","footer":true,"layout":"default","navbar":true,"pagination":false,"sidebar":false,"timestamp":true,"toc":true,"typesetting":"default"},"activeMetadata":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:7:children:140:frontMatter","activePath":"$5:0:props:activePath","directories":[{"name":"docs","route":"/docs","children":[{"name":"search-bar-docs","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:search-bar-docs:title","isUnderCurrentDocsTree":false},{"name":"index","route":"/docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:2:frontMatter","title":"Home","type":"doc"},{"name":"introduction","route":"/docs/introduction","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:3:frontMatter","title":"Introduction","type":"doc"},{"name":"core-concepts","route":"/docs/core-concepts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:4:frontMatter","title":"Core Concepts","type":"doc"},{"name":"sdks-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:sdks-section:title","isUnderCurrentDocsTree":false},{"name":"create-client-sdks","route":"/docs/create-client-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:6:frontMatter","title":"Generate SDKs","type":"doc"},{"name":"prep-openapi","route":"/docs/prep-openapi","children":[{"name":"best-practices","route":"/docs/prep-openapi/best-practices","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:0:frontMatter","title":"OpenAPI overview and best practices","type":"doc"},{"name":"linting","route":"/docs/prep-openapi/linting","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:1:frontMatter","title":"OpenAPI document linting","type":"doc"},{"name":"maintenance","route":"/docs/prep-openapi/maintenance","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:2:frontMatter","title":"Speakeasy Suggest","type":"doc"},{"name":"overlays","route":"/docs/prep-openapi/overlays","children":[{"name":"apply-overlays","route":"/docs/prep-openapi/overlays/apply-overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:3:children:0:frontMatter","title":"Apply an overlay","type":"doc"},{"name":"create-overlays","route":"/docs/prep-openapi/overlays/create-overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:3:children:1:frontMatter","title":"Create overlays","type":"doc"}],"title":"Overlays","type":"doc"},{"name":"transformations","route":"/docs/prep-openapi/transformations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:4:frontMatter","title":"Transformations","type":"doc"}],"title":"Prepare OpenAPI Spec","type":"doc"},{"name":"customize","route":"/docs/customize","children":[{"name":"basics","route":"/docs/customize/basics","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:1:frontMatter","title":"Customization Basics","type":"doc"},{"name":"structure","route":"/docs/customize/structure","children":[{"name":"imports","route":"/docs/customize/structure/imports","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:2:children:0:frontMatter","title":"Customize imports","type":"doc"},{"name":"namespaces","route":"/docs/customize/structure/namespaces","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:2:children:1:frontMatter","title":"Customize namespaces","type":"doc"}],"title":"Structure","type":"doc"},{"name":"data-model","route":"/docs/customize/data-model","children":[{"name":"types","route":"/docs/customize/data-model/types","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:1:frontMatter","title":"Types","type":"doc"},{"name":"enums","route":"/docs/customize/data-model/enums","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:2:frontMatter","title":"Enums","type":"doc"},{"name":"oneof-schemas","route":"/docs/customize/data-model/oneof-schemas","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:3:frontMatter","title":"OneOf","type":"doc"},{"name":"complex-numbers","route":"/docs/customize/data-model/complex-numbers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:4:frontMatter","title":"Complex Numbers","type":"doc"}],"title":"Data Model","type":"doc"},{"name":"methods","route":"/docs/customize/methods","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:4:frontMatter","title":"Customize methods","type":"doc"},{"name":"responses","route":"/docs/customize/responses","children":[{"name":"responses","route":"/docs/customize/responses/responses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:5:children:1:frontMatter","title":"Customize Responses","type":"doc"},{"name":"errors","route":"/docs/customize/responses/errors","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:5:children:2:frontMatter","title":"Error Handling","type":"doc"}],"title":"Responses & Error Handling","type":"doc"},{"name":"globals","route":"/docs/customize/globals","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:6:frontMatter","title":"Global Parameters","type":"doc"},{"name":"servers","route":"/docs/customize/servers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:7:frontMatter","title":"Configure servers","type":"doc"},{"name":"deprecations","route":"/docs/customize/deprecations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:8:frontMatter","title":"Deprecations","type":"doc"},{"name":"authentication","route":"/docs/customize/authentication","children":[{"name":"overview","route":"/docs/customize/authentication/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:1:frontMatter","title":"Overview","type":"doc"},{"name":"configuration","route":"/docs/customize/authentication/configuration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:2:frontMatter","title":"Configuration Options","type":"doc"},{"name":"simple-schemes","route":"/docs/customize/authentication/simple-schemes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:3:frontMatter","title":"Standard security schemes","type":"doc"},{"name":"oauth","route":"/docs/customize/authentication/oauth","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:4:frontMatter","title":"OAuth 2.0 Authentication","type":"doc"},{"name":"custom-security-schemes","route":"/docs/customize/authentication/custom-security-schemes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:5:frontMatter","title":"Custom Security Schemes","type":"doc"},{"name":"security-callbacks","route":"/docs/customize/authentication/security-callbacks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:6:frontMatter","title":"Security Callbacks","type":"doc"}],"title":"Security & Authentication","type":"doc"},{"name":"runtime","route":"/docs/customize/runtime","children":[{"name":"retries","route":"/docs/customize/runtime/retries","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:1:frontMatter","title":"Enable Retries","type":"doc"},{"name":"timeouts","route":"/docs/customize/runtime/timeouts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:2:frontMatter","title":"Enable Timeouts","type":"doc"},{"name":"pagination","route":"/docs/customize/runtime/pagination","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:3:frontMatter","title":"Enable Pagination","type":"doc"},{"name":"streaming","route":"/docs/customize/runtime/streaming","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:4:frontMatter","title":"Enable Streaming","type":"doc"},{"name":"server-sent-events","route":"/docs/customize/runtime/server-sent-events","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:5:frontMatter","title":"Enable Server-Sent Events","type":"doc"},{"name":"jsonl-events","route":"/docs/customize/runtime/jsonl-events","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:6:frontMatter","title":"Enable JSON Lines Responses","type":"doc"},{"name":"custom-http-client","route":"/docs/customize/runtime/custom-http-client","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:7:frontMatter","title":"Customize HTTP Client","type":"doc"},{"name":"override-accept-headers","route":"/docs/customize/runtime/override-accept-headers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:8:frontMatter","title":"Override accept headers","type":"doc"}],"title":"SDK Behavior","type":"doc"},{"name":"webhooks","route":"/docs/customize/webhooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:11:frontMatter","title":"Add webhooks to your SDKs","type":"doc"},{"name":"code","route":"/docs/customize/code","children":[{"name":"code-regions","route":"/docs/customize/code/code-regions","children":[{"name":"overview","route":"/docs/customize/code/code-regions/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:1:frontMatter","title":"Custom code regions","type":"doc"},{"name":"python","route":"/docs/customize/code/code-regions/python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:2:frontMatter","title":"Custom code regions in Python","type":"doc"},{"name":"typescript","route":"/docs/customize/code/code-regions/typescript","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:3:frontMatter","title":"Custom code regions in TypeScript","type":"doc"},{"name":"java","route":"/docs/customize/code/code-regions/java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:4:frontMatter","title":"Custom code regions in Java","type":"doc"}],"title":"Code Regions","type":"doc"},{"name":"monkey-patching","route":"/docs/customize/code/monkey-patching","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:2:frontMatter","title":"Monkey patching","type":"doc"},{"name":"sdk-hooks","route":"/docs/customize/code/sdk-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:3:frontMatter","title":"Custom code with SDK hooks","type":"doc"}],"title":"Add Custom Code","type":"doc"},{"name":"typescript","route":"/docs/customize/typescript","children":[{"name":"additional-index-exports","route":"/docs/customize/typescript/additional-index-exports","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:0:frontMatter","title":"Additional index exports","type":"doc"},{"name":"configuring-module-format","route":"/docs/customize/typescript/configuring-module-format","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:1:frontMatter","title":"Configuring module format","type":"doc"},{"name":"disabling-barrel-files","route":"/docs/customize/typescript/disabling-barrel-files","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:2:frontMatter","title":"Disabling barrel files","type":"doc"},{"name":"model-validation-and-serialization","route":"/docs/customize/typescript/model-validation-and-serialization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:3:frontMatter","title":"Model validation and serialization","type":"doc"},{"name":"react-hooks","route":"/docs/customize/typescript/react-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:4:frontMatter","title":"Generating React Hooks from OpenAPI/Swagger","type":"doc"}],"title":"TypeScript","type":"doc"}],"title":"Customize","type":"doc"},{"name":"manage","route":"/docs/manage","children":[{"name":"versioning","route":"/docs/manage/versioning","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:1:frontMatter","title":"Version Control","type":"doc"},{"name":"github-setup","route":"/docs/manage/github-setup","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:2:frontMatter","title":"Github Setup","type":"doc"},{"name":"sdk-sandbox","route":"/docs/manage/sdk-sandbox","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:3:frontMatter","title":"Enable Sandbox","type":"doc"},{"name":"migrate","route":"/docs/manage/migrate","children":[{"name":"poetry-2-update","route":"/docs/manage/migrate/poetry-2-update","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:0:frontMatter","title":"Poetry 2.0 and Python 3.9 Updates","type":"doc"},{"name":"python-migration","route":"/docs/manage/migrate/python-migration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:1:frontMatter","title":"Migrate from the Python v1 SDK","type":"doc"},{"name":"workflow-migration","route":"/docs/manage/migrate/workflow-migration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:2:frontMatter","title":"Migrate to Speakeasy workflows","type":"doc"}],"title":"Migrate","type":"doc"},{"name":"forward-compatibility","route":"/docs/manage/forward-compatibility","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:5:frontMatter","title":"Forward Compatibility","type":"doc"},{"name":"breaking-changes","route":"/docs/manage/breaking-changes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:6:frontMatter","title":"Handle Breaking Changes","type":"doc"}],"title":"Manage","type":"doc"},{"name":"publish-sdk","route":"/docs/publish-sdk","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:10:frontMatter","title":"Publish SDK","type":"doc"},{"name":"languages","route":"/docs/languages","children":[{"name":"philosophy","route":"/docs/languages/philosophy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:1:frontMatter","title":"Design philosophy","type":"doc"},{"name":"maturity","route":"/docs/languages/maturity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:2:frontMatter","title":"Maturity","type":"doc"},{"name":"typescript","route":"/docs/languages/typescript","children":[{"name":"methodology-ts","route":"/docs/languages/typescript/methodology-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:1:frontMatter","title":"TypeScript design","type":"doc"},{"name":"oss-comparison-ts","route":"/docs/languages/typescript/oss-comparison-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"},{"name":"migrating-from-oss","route":"/docs/languages/typescript/migrating-from-oss","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:3:frontMatter","title":"Migrating from OpenAPI Generator to Speakeasy","type":"doc"},{"name":"feature-support","route":"/docs/languages/typescript/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:4:frontMatter","title":"Feature reference","type":"doc"},{"name":"standalone-functions","route":"/docs/languages/typescript/standalone-functions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:5:frontMatter","title":"Standalone functions","type":"doc"}],"title":"TypeScript","type":"doc"},{"name":"python","route":"/docs/languages/python","children":[{"name":"methodology-python","route":"/docs/languages/python/methodology-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:1:frontMatter","title":"Python design","type":"doc"},{"name":"oss-comparison-python","route":"/docs/languages/python/oss-comparison-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"},{"name":"feature-support","route":"/docs/languages/python/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:3:frontMatter","title":"Feature reference","type":"doc"}],"title":"Python","type":"doc"},{"name":"golang","route":"/docs/languages/golang","children":[{"name":"methodology-go","route":"/docs/languages/golang/methodology-go","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:1:frontMatter","title":"Go design","type":"doc"},{"name":"oss-comparison-go","route":"/docs/languages/golang/oss-comparison-go","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"},{"name":"feature-support","route":"/docs/languages/golang/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:3:frontMatter","title":"Feature reference","type":"doc"}],"title":"Go","type":"doc"},{"name":"java","route":"/docs/languages/java","children":[{"name":"methodology-java","route":"/docs/languages/java/methodology-java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:1:frontMatter","title":"Java design","type":"doc"},{"name":"oss-comparison-java","route":"/docs/languages/java/oss-comparison-java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"},{"name":"feature-support","route":"/docs/languages/java/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:3:frontMatter","title":"Feature reference","type":"doc"},{"name":"param-encoding","route":"/docs/languages/java/param-encoding","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:4:frontMatter","title":"Parameter encoding","type":"doc"}],"title":"Java","type":"doc"},{"name":"csharp","route":"/docs/languages/csharp","children":[{"name":"methodology-csharp","route":"/docs/languages/csharp/methodology-csharp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:7:children:1:frontMatter","title":"C# design","type":"doc"},{"name":"oss-comparison-csharp","route":"/docs/languages/csharp/oss-comparison-csharp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:7:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"}],"title":"C#","type":"doc"},{"name":"php","route":"/docs/languages/php","children":[{"name":"methodology-php","route":"/docs/languages/php/methodology-php","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:8:children:1:frontMatter","title":"PHP design","type":"doc"},{"name":"oss-comparison-php","route":"/docs/languages/php/oss-comparison-php","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:8:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc"}],"title":"PHP","type":"doc"},{"name":"ruby","route":"/docs/languages/ruby","children":[{"name":"methodology-ruby","route":"/docs/languages/ruby/methodology-ruby","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:9:children:1:frontMatter","title":"Ruby design [coming soon]","type":"doc"}],"title":"Ruby [alpha]","type":"doc"},{"name":"rust","route":"/docs/languages/rust","children":[{"name":"methodology-rust","route":"/docs/languages/rust/methodology-rust","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:10:children:1:frontMatter","title":"Rust design [coming soon]","type":"doc"}],"title":"Rust [coming]","type":"doc"},{"name":"cpp","route":"/docs/languages/cpp","children":[{"name":"methodology-cpp","route":"/docs/languages/cpp/methodology-cpp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:11:children:1:frontMatter","title":"C++ design [coming soon]","type":"doc"}],"title":"C++ [coming]","type":"doc"},{"name":"unity","route":"/docs/languages/unity","children":[{"name":"methodology-unity","route":"/docs/languages/unity/methodology-unity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:12:children:1:frontMatter","title":"Unity design [coming soon]","type":"doc"}],"title":"Unity [beta]","type":"doc"},{"name":"swift","route":"/docs/languages/swift","children":[{"name":"methodology-swift","route":"/docs/languages/swift/methodology-swift","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:13:children:0:frontMatter","title":"Create Swift SDKs from OpenAPI / Swagger","type":"doc"}],"title":"Swift","type":"doc"}],"title":"Language Design","type":"doc"},{"name":"agent-tools-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:agent-tools-section:title","isUnderCurrentDocsTree":false},{"name":"model-context-protocol","route":"/docs/model-context-protocol","children":[{"name":"custom-mcp-tools-resources","route":"/docs/model-context-protocol/custom-mcp-tools-resources","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:13:children:0:frontMatter","title":"Custom MCP Server Extensions","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:13:frontMatter","title":"Generate MCP servers","type":"doc"},{"name":"terraform-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:terraform-section:title","isUnderCurrentDocsTree":false},{"name":"create-terraform","route":"/docs/create-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:15:frontMatter","title":"Generate Terraform Provider","type":"doc"},{"name":"publish-terraform","route":"/docs/publish-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:16:frontMatter","title":"Publish Terraform Provider","type":"doc"},{"name":"terraform","route":"/docs/terraform","children":[{"name":"index","route":"/docs/terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:1:frontMatter","title":"Overview","type":"doc"},{"name":"entity-mapping","route":"/docs/terraform/entity-mapping","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:2:frontMatter","title":"Map API Entities","type":"doc"},{"name":"property-customization","route":"/docs/terraform/property-customization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:3:frontMatter","title":"Property Customization","type":"doc"},{"name":"validation-dependencies","route":"/docs/terraform/validation-dependencies","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:4:frontMatter","title":"Validation and Dependencies","type":"doc"},{"name":"plan-modification","route":"/docs/terraform/plan-modification","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:5:frontMatter","title":"Plan Modification","type":"doc"},{"name":"configuration","route":"/docs/terraform/configuration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:6:frontMatter","title":"Configuration","type":"doc"},{"name":"advanced-features","route":"/docs/terraform/advanced-features","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:7:frontMatter","title":"Advanced Features","type":"doc"},{"name":"schema-keywords","route":"/docs/terraform/schema-keywords","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:8:frontMatter","title":"Schema Keywords","type":"doc"}],"title":"Customize Terraform","type":"doc"},{"name":"testing-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:testing-section:title","isUnderCurrentDocsTree":false},{"name":"testing","route":"/docs/testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:19:frontMatter","title":"Start Testing","type":"doc"},{"name":"customize-testing","route":"/docs/customize-testing","children":[{"name":"bootstrapping-test-generation","route":"/docs/customize-testing/bootstrapping-test-generation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:0:frontMatter","title":"Bootstrapping SDK Tests","type":"doc"},{"name":"customizing-sdk-tests","route":"/docs/customize-testing/customizing-sdk-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:1:frontMatter","title":"Customizing SDK Tests","type":"doc"},{"name":"github-actions","route":"/docs/customize-testing/github-actions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:2:frontMatter","title":"Testing in GitHub Actions","type":"doc"},{"name":"openapi-in-tests","route":"/docs/customize-testing/openapi-in-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:3:frontMatter","title":"OpenAPI Data in Tests","type":"doc"},{"name":"running-tests","route":"/docs/customize-testing/running-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:4:frontMatter","title":"Running SDK Tests","type":"doc"}],"title":"SDK Testing","type":"doc"},{"name":"api-contract-tests","route":"/docs/api-contract-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:21:frontMatter","title":"Configure Custom API Contract Tests","type":"doc"},{"name":"docs-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:docs-section:title","isUnderCurrentDocsTree":false},{"name":"sdk-docs","route":"/docs/sdk-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:23:frontMatter","title":"Customize SDK Documentation","type":"doc"},{"name":"code-samples","route":"/docs/code-samples","children":[{"name":"automated-code-sample-urls","route":"/docs/code-samples/automated-code-sample-urls","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:0:frontMatter","title":"Automated code sample URLs","type":"doc"},{"name":"code-samples-api","route":"/docs/code-samples/code-samples-api","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:1:frontMatter","title":"The Code Samples API","type":"doc"},{"name":"generate-code-samples","route":"/docs/code-samples/generate-code-samples","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:2:frontMatter","title":"Generating code samples for your SDK","type":"doc"}],"title":"Code Samples","type":"doc"},{"name":"integrations","route":"/docs/integrations","children":[{"name":"_get-public-url-snippet","route":"/docs/integrations/_get-public-url-snippet","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:0:frontMatter","title":" Get Public URL Snippet","type":"doc"},{"name":"bump","route":"/docs/integrations/bump","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:1:frontMatter","title":"Integrate Speakeasy with Bump.sh","type":"doc"},{"name":"mintlify","route":"/docs/integrations/mintlify","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:2:frontMatter","title":"Integrate Speakeasy with Mintlify","type":"doc"},{"name":"readme","route":"/docs/integrations/readme","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:3:frontMatter","title":"Integrate Speakeasy with ReadMe","type":"doc"},{"name":"scalar","route":"/docs/integrations/scalar","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:4:frontMatter","title":"Integrate Speakeasy with Scalar","type":"doc"}],"title":"Integrations","type":"doc"},{"name":"snippet-ai","route":"/docs/snippet-ai","children":[{"name":"overview","route":"/docs/snippet-ai/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:1:frontMatter","title":"Overview","type":"doc"},{"name":"integrate-via-react","route":"/docs/snippet-ai/integrate-via-react","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:2:frontMatter","title":"Integrate via React","type":"doc"},{"name":"integrate-via-web-component","route":"/docs/snippet-ai/integrate-via-web-component","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:3:frontMatter","title":"Integrate via Web Component","type":"doc"},{"name":"integrate-via-script","route":"/docs/snippet-ai/integrate-via-script","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:4:frontMatter","title":"Integrate via Script","type":"doc"}],"title":"SnippetAI","type":"doc"},{"name":"reference-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:reference-section:title","isUnderCurrentDocsTree":false},{"name":"speakeasy-reference","route":"/docs/speakeasy-reference","children":[{"name":"cli","route":"/docs/speakeasy-reference/cli","children":[{"name":"getting-started","route":"/docs/speakeasy-reference/cli/getting-started","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:1:frontMatter","title":"Getting Started","type":"doc"},{"name":"mise-toolkit","route":"/docs/speakeasy-reference/cli/mise-toolkit","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:2:frontMatter","title":"Using with mise toolkit","type":"doc"},{"name":"ask","route":"/docs/speakeasy-reference/cli/ask","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:3:frontMatter","title":"ask","type":"doc"},{"name":"auth","route":"/docs/speakeasy-reference/cli/auth","children":[{"name":"login","route":"/docs/speakeasy-reference/cli/auth/login","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:4:children:0:frontMatter","title":"login","type":"doc"},{"name":"logout","route":"/docs/speakeasy-reference/cli/auth/logout","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:4:children:1:frontMatter","title":"logout","type":"doc"},{"name":"switch","route":"/docs/speakeasy-reference/cli/auth/switch","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:4:children:2:frontMatter","title":"switch","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:4:frontMatter","title":"auth","type":"doc"},{"name":"billing","route":"/docs/speakeasy-reference/cli/billing","children":[{"name":"activate","route":"/docs/speakeasy-reference/cli/billing/activate","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:5:children:0:frontMatter","title":"activate","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:5:frontMatter","title":"billing","type":"doc"},{"name":"bump","route":"/docs/speakeasy-reference/cli/bump","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:6:frontMatter","title":"bump","type":"doc"},{"name":"clean","route":"/docs/speakeasy-reference/cli/clean","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:7:frontMatter","title":"clean","type":"doc"},{"name":"configure","route":"/docs/speakeasy-reference/cli/configure","children":[{"name":"github","route":"/docs/speakeasy-reference/cli/configure/github","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:children:0:frontMatter","title":"github","type":"doc"},{"name":"publishing","route":"/docs/speakeasy-reference/cli/configure/publishing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:children:1:frontMatter","title":"publishing","type":"doc"},{"name":"sources","route":"/docs/speakeasy-reference/cli/configure/sources","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:children:2:frontMatter","title":"sources","type":"doc"},{"name":"targets","route":"/docs/speakeasy-reference/cli/configure/targets","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:children:3:frontMatter","title":"targets","type":"doc"},{"name":"tests","route":"/docs/speakeasy-reference/cli/configure/tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:children:4:frontMatter","title":"tests","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:frontMatter","title":"configure","type":"doc"},{"name":"lint","route":"/docs/speakeasy-reference/cli/lint","children":[{"name":"arazzo","route":"/docs/speakeasy-reference/cli/lint/arazzo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:9:children:0:frontMatter","title":"arazzo","type":"doc"},{"name":"config","route":"/docs/speakeasy-reference/cli/lint/config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:9:children:1:frontMatter","title":"config","type":"doc"},{"name":"openapi","route":"/docs/speakeasy-reference/cli/lint/openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:9:children:2:frontMatter","title":"openapi","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:9:frontMatter","title":"lint","type":"doc"},{"name":"merge","route":"/docs/speakeasy-reference/cli/merge","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:10:frontMatter","title":"merge","type":"doc"},{"name":"openapi","route":"/docs/speakeasy-reference/cli/openapi","children":[{"name":"diff","route":"/docs/speakeasy-reference/cli/openapi/diff","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:0:frontMatter","title":"diff","type":"doc"},{"name":"lint","route":"/docs/speakeasy-reference/cli/openapi/lint","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:1:frontMatter","title":"lint","type":"doc"},{"name":"transform","route":"/docs/speakeasy-reference/cli/openapi/transform","children":[{"name":"cleanup","route":"/docs/speakeasy-reference/cli/openapi/transform/cleanup","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:0:frontMatter","title":"cleanup","type":"doc"},{"name":"convert-swagger","route":"/docs/speakeasy-reference/cli/openapi/transform/convert-swagger","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:1:frontMatter","title":"convert-swagger","type":"doc"},{"name":"filter-operations","route":"/docs/speakeasy-reference/cli/openapi/transform/filter-operations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:2:frontMatter","title":"filter-operations","type":"doc"},{"name":"format","route":"/docs/speakeasy-reference/cli/openapi/transform/format","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:3:frontMatter","title":"format","type":"doc"},{"name":"normalize","route":"/docs/speakeasy-reference/cli/openapi/transform/normalize","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:4:frontMatter","title":"normalize","type":"doc"},{"name":"remove-unused","route":"/docs/speakeasy-reference/cli/openapi/transform/remove-unused","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:5:frontMatter","title":"remove-unused","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:frontMatter","title":"transform","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:frontMatter","title":"openapi","type":"doc"},{"name":"overlay","route":"/docs/speakeasy-reference/cli/overlay","children":[{"name":"apply","route":"/docs/speakeasy-reference/cli/overlay/apply","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:12:children:0:frontMatter","title":"apply","type":"doc"},{"name":"compare","route":"/docs/speakeasy-reference/cli/overlay/compare","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:12:children:1:frontMatter","title":"compare","type":"doc"},{"name":"validate","route":"/docs/speakeasy-reference/cli/overlay/validate","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:12:children:2:frontMatter","title":"validate","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:12:frontMatter","title":"overlay","type":"doc"},{"name":"quickstart","route":"/docs/speakeasy-reference/cli/quickstart","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:13:frontMatter","title":"quickstart","type":"doc"},{"name":"run","route":"/docs/speakeasy-reference/cli/run","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:14:frontMatter","title":"run","type":"doc"},{"name":"status","route":"/docs/speakeasy-reference/cli/status","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:15:frontMatter","title":"status","type":"doc"},{"name":"suggest","route":"/docs/speakeasy-reference/cli/suggest","children":[{"name":"error-types","route":"/docs/speakeasy-reference/cli/suggest/error-types","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:16:children:0:frontMatter","title":"error-types","type":"doc"},{"name":"operation-ids","route":"/docs/speakeasy-reference/cli/suggest/operation-ids","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:16:children:1:frontMatter","title":"operation-ids","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:16:frontMatter","title":"suggest","type":"doc"},{"name":"tag","route":"/docs/speakeasy-reference/cli/tag","children":[{"name":"apply","route":"/docs/speakeasy-reference/cli/tag/apply","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:17:children:0:frontMatter","title":"apply","type":"doc"},{"name":"promote","route":"/docs/speakeasy-reference/cli/tag/promote","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:17:children:1:frontMatter","title":"promote","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:17:frontMatter","title":"tag","type":"doc"},{"name":"test","route":"/docs/speakeasy-reference/cli/test","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:18:frontMatter","title":"test","type":"doc"},{"name":"update","route":"/docs/speakeasy-reference/cli/update","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:19:frontMatter","title":"update","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:frontMatter","title":"CLI","type":"doc"},{"name":"generation","route":"/docs/speakeasy-reference/generation","children":[{"name":"gen-yaml","route":"/docs/speakeasy-reference/generation/gen-yaml","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:1:frontMatter","title":"Config File","type":"doc"},{"name":"ci-cd-pipeline","route":"/docs/speakeasy-reference/generation/ci-cd-pipeline","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:2:frontMatter","title":"CI/CD Pipeline","type":"doc"},{"name":"ts-config","route":"/docs/speakeasy-reference/generation/ts-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:3:frontMatter","title":"TypeScript Configuration","type":"doc"},{"name":"python-config","route":"/docs/speakeasy-reference/generation/python-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:4:frontMatter","title":"Python Configuration","type":"doc"},{"name":"go-config","route":"/docs/speakeasy-reference/generation/go-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:5:frontMatter","title":"Go Configuration","type":"doc"},{"name":"java-config","route":"/docs/speakeasy-reference/generation/java-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:6:frontMatter","title":"Java Configuration","type":"doc"},{"name":"csharp-config","route":"/docs/speakeasy-reference/generation/csharp-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:7:frontMatter","title":"C# Configuration","type":"doc"},{"name":"php-config","route":"/docs/speakeasy-reference/generation/php-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:8:frontMatter","title":"PHP Configuration","type":"doc"},{"name":"ruby-config","route":"/docs/speakeasy-reference/generation/ruby-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:9:frontMatter","title":"Ruby Configuration","type":"doc"},{"name":"swift-config","route":"/docs/speakeasy-reference/generation/swift-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:10:frontMatter","title":"Swift Configuration","type":"doc"},{"name":"terraform-config","route":"/docs/speakeasy-reference/generation/terraform-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:11:frontMatter","title":"Terraform Configuration","type":"doc"}],"title":"Generation Config","type":"doc"},{"name":"extensions","route":"/docs/speakeasy-reference/extensions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:3:frontMatter","title":"Speakeasy extensions","type":"doc"},{"name":"workflow-file","route":"/docs/speakeasy-reference/workflow-file","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:4:frontMatter","title":"Speakeasy Workflow File","type":"doc"}],"title":"Speakeasy","type":"doc"},{"name":"supported","route":"/docs/supported","children":[{"name":"openapi","route":"/docs/supported/openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:0:frontMatter","title":"OpenAPI Support Matrix","type":"doc"},{"name":"terraform","route":"/docs/supported/terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:frontMatter","title":"Speakeasy Terraform provider support matrix","type":"doc"}],"title":"Supported","type":"doc"},{"name":"support-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:support-section:title","isUnderCurrentDocsTree":false},{"name":"slack-community","href":"https://go.speakeasy.com/slack","title":"Slack Community","type":"doc"},{"name":"enterprise-support","route":"/docs/enterprise-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:32:frontMatter","title":"Enterprise Support","type":"doc"},{"name":"privacy-security-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:0:data:privacy-security-section:title","isUnderCurrentDocsTree":false},{"name":"product-security","route":"/docs/product-security","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:34:frontMatter","title":"Product Security","type":"doc"},{"name":"privacy-policy","route":"/docs/privacy-policy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:35:frontMatter","title":"Privacy Policy","type":"doc"},{"name":"terms-of-service","route":"/docs/terms-of-service","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:36:frontMatter","title":"Terms of Service","type":"doc"},{"name":"guides","route":"/docs/guides","children":[{"name":"code-samples-without-github-actions","route":"/docs/guides/code-samples-without-github-actions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:37:children:0:frontMatter","title":"Using the CLI to populate code samples without GitHub Actions","type":"doc"}],"title":"Guides","type":"doc"}],"title":"Documentation","type":"page","display":"children"},{"name":"openapi","route":"/openapi","children":[{"name":"search-bar-openapi","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:0:data:search-bar-openapi:title","isUnderCurrentDocsTree":false},{"name":"index","route":"/openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:2:frontMatter","title":"Introduction","type":"doc"},{"name":"info","route":"/openapi/info","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:3:frontMatter","title":"Info","type":"doc"},{"name":"servers","route":"/openapi/servers","children":[{"name":"server-variables","route":"/openapi/servers/server-variables","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:4:children:0:frontMatter","title":"Server Variables in OpenAPI best practices","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:4:frontMatter","title":"Servers","type":"doc"},{"name":"security","route":"/openapi/security","children":[{"name":"custom-auth","route":"/openapi/security/custom-auth","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:0:frontMatter","title":"Custom Security Schemes in OpenAPI best practices","type":"doc"},{"name":"security-schemes","route":"/openapi/security/security-schemes","children":[{"name":"index","route":"/openapi/security/security-schemes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:0:frontMatter","title":"Security Schemes in OpenAPI","type":"doc"},{"name":"security-api-key","route":"/openapi/security/security-schemes/security-api-key","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:1:frontMatter","title":"API Key in OpenAPI best practices","type":"doc"},{"name":"security-http","route":"/openapi/security/security-schemes/security-http","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:2:frontMatter","title":"HTTP Basic in OpenAPI","type":"doc"},{"name":"security-mutualtls","route":"/openapi/security/security-schemes/security-mutualtls","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:3:frontMatter","title":"MutualTLS in OpenAPI","type":"doc"},{"name":"security-oauth2","route":"/openapi/security/security-schemes/security-oauth2","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:4:frontMatter","title":"OAuth 2.0 in OpenAPI best practices","type":"doc"},{"name":"security-openid","route":"/openapi/security/security-schemes/security-openid","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:5:frontMatter","title":"OpenID Connect in OpenAPI best practices","type":"doc"}],"title":"Security Schemes","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:frontMatter","title":"Security","type":"doc"},{"name":"paths","route":"/openapi/paths","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:6:frontMatter","title":"Paths","type":"doc"},{"name":"operations","route":"/openapi/operations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:7:frontMatter","title":"Operations","type":"doc"},{"name":"content","route":"/openapi/content","children":[{"name":"file-uploads","route":"/openapi/content/file-uploads","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:8:children:1:frontMatter","title":"File Uploads","type":"doc"},{"name":"server-sent-events","route":"/openapi/content/server-sent-events","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:8:children:2:frontMatter","title":"Server-Sent Events","type":"doc"},{"name":"jsonl","route":"/openapi/content/jsonl","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:8:children:3:frontMatter","title":"JSONL","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:8:frontMatter","title":"Content & Media","type":"doc"},{"name":"schemas","route":"/openapi/schemas","children":[{"name":"arrays","route":"/openapi/schemas/arrays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:0:frontMatter","title":"Arrays in OpenAPI best practices","type":"doc"},{"name":"booleans","route":"/openapi/schemas/booleans","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:1:frontMatter","title":"Booleans in OpenAPI best practices","type":"doc"},{"name":"composition","route":"/openapi/schemas/composition","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:2:frontMatter","title":"Schema Composition","type":"doc"},{"name":"enums","route":"/openapi/schemas/enums","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:3:frontMatter","title":"Enums in OpenAPI best practices","type":"doc"},{"name":"null","route":"/openapi/schemas/null","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:4:frontMatter","title":"Null in OpenAPI best practices","type":"doc"},{"name":"numbers","route":"/openapi/schemas/numbers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:5:frontMatter","title":"Numbers and Integers in OpenAPI best practices","type":"doc"},{"name":"objects","route":"/openapi/schemas/objects","children":[{"name":"polymorphism","route":"/openapi/schemas/objects/polymorphism","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:6:children:0:frontMatter","title":"oneOf, allOf, anyOf","type":"doc"},{"name":"xml","route":"/openapi/schemas/objects/xml","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:6:children:1:frontMatter","title":"XML Objects","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:6:frontMatter","title":"Objects in OpenAPI best practices","type":"doc"},{"name":"strings","route":"/openapi/schemas/strings","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:7:frontMatter","title":"Strings in OpenAPI best practices","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:frontMatter","title":"Data Types","type":"doc"},{"name":"requests","route":"/openapi/requests","children":[{"name":"parameters","route":"/openapi/requests/parameters","children":[{"name":"cookie-parameters","route":"/openapi/requests/parameters/cookie-parameters","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:children:0:children:0:frontMatter","title":"Cookie Parameters in OpenAPI best practices","type":"doc"},{"name":"header-parameters","route":"/openapi/requests/parameters/header-parameters","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:children:0:children:1:frontMatter","title":"Header Parameters in OpenAPI best practices","type":"doc"},{"name":"path-parameters","route":"/openapi/requests/parameters/path-parameters","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:children:0:children:2:frontMatter","title":"Path Parameters in OpenAPI best practices","type":"doc"},{"name":"query-parameters","route":"/openapi/requests/parameters/query-parameters","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:children:0:children:3:frontMatter","title":"Query Parameters in OpenAPI best practices","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:children:0:frontMatter","title":"Request Parameters in OpenAPI best practices","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:frontMatter","title":"Requests","type":"doc"},{"name":"responses","route":"/openapi/responses","children":[{"name":"errors","route":"/openapi/responses/errors","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:children:1:frontMatter","title":"Errors","type":"doc"},{"name":"rate-limiting","route":"/openapi/responses/rate-limiting","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:children:2:frontMatter","title":"Rate Limiting","type":"doc"},{"name":"headers","route":"/openapi/responses/headers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:children:3:frontMatter","title":"Headers","type":"doc"},{"name":"links","route":"/openapi/responses/links","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:children:4:frontMatter","title":"Links","type":"doc"},{"name":"retries","route":"/openapi/responses/retries","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:children:5:frontMatter","title":"Retries","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:frontMatter","title":"Responses","type":"doc"},{"name":"components","route":"/openapi/components","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:12:frontMatter","title":"Components","type":"doc"},{"name":"tags","route":"/openapi/tags","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:13:frontMatter","title":"Tags","type":"doc"},{"name":"external-documentation","route":"/openapi/external-documentation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:14:frontMatter","title":"External Documentation","type":"doc"},{"name":"references","route":"/openapi/references","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:15:frontMatter","title":"References ($ref)","type":"doc"},{"name":"examples","route":"/openapi/examples","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:16:frontMatter","title":"Examples","type":"doc"},{"name":"extensions","route":"/openapi/extensions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:17:frontMatter","title":"Extensions","type":"doc"},{"name":"overlays","route":"/openapi/overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:18:frontMatter","title":"Overlays","type":"doc"},{"name":"webhooks","route":"/openapi/webhooks","children":[{"name":"callbacks","route":"/openapi/webhooks/callbacks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:19:children:0:frontMatter","title":"Callbacks","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:19:frontMatter","title":"Webhooks","type":"doc"},{"name":"arazzo","route":"/openapi/arazzo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:20:frontMatter","title":"Arazzo","type":"doc"},{"name":"frameworks","route":"/openapi/frameworks","children":[{"name":"js-ts-frameworks","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:0:data:js-ts-frameworks:title","isUnderCurrentDocsTree":false},{"name":"nestjs","route":"/openapi/frameworks/nestjs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:2:frontMatter","title":"NestJS","type":"doc"},{"name":"fastify","route":"/openapi/frameworks/fastify","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:3:frontMatter","title":"Fastify","type":"doc"},{"name":"hono","route":"/openapi/frameworks/hono","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:4:frontMatter","title":"Hono","type":"doc"},{"name":"trpc","route":"/openapi/frameworks/trpc","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:5:frontMatter","title":"tRPC","type":"doc"},{"name":"tsoa","route":"/openapi/frameworks/tsoa","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:6:frontMatter","title":"tsoa","type":"doc"},{"name":"typespec","route":"/openapi/frameworks/typespec","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:7:frontMatter","title":"TypeSpec","type":"doc"},{"name":"elysia","route":"/openapi/frameworks/elysia","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:8:frontMatter","title":"Elysia","type":"doc"},{"name":"zod","route":"/openapi/frameworks/zod","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:9:frontMatter","title":"Zod","type":"doc"},{"name":"python-frameworks","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:0:data:python-frameworks:title","isUnderCurrentDocsTree":false},{"name":"fastapi","route":"/openapi/frameworks/fastapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:11:frontMatter","title":"FastAPI","type":"doc"},{"name":"django","route":"/openapi/frameworks/django","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:12:frontMatter","title":"Django","type":"doc"},{"name":"flask","route":"/openapi/frameworks/flask","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:13:frontMatter","title":"Flask","type":"doc"},{"name":"pydantic","route":"/openapi/frameworks/pydantic","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:14:frontMatter","title":"Pydantic","type":"doc"},{"name":"go-frameworks","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:0:data:go-frameworks:title","isUnderCurrentDocsTree":false},{"name":"goa","route":"/openapi/frameworks/goa","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:16:frontMatter","title":"Goa","type":"doc"},{"name":"grpc-gateway","route":"/openapi/frameworks/grpc-gateway","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:17:frontMatter","title":"gRPC-Gateway","type":"doc"},{"name":"gnostic","route":"/openapi/frameworks/gnostic","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:18:frontMatter","title":"Gnostic","type":"doc"},{"name":"java-frameworks","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:0:data:java-frameworks:title","isUnderCurrentDocsTree":false},{"name":"springboot","route":"/openapi/frameworks/springboot","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:20:frontMatter","title":"Spring Boot","type":"doc"},{"name":"php-frameworks","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:0:data:php-frameworks:title","isUnderCurrentDocsTree":false},{"name":"laravel","route":"/openapi/frameworks/laravel","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:22:frontMatter","title":"Laravel","type":"doc"},{"name":"ruby-frameworks","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:0:data:ruby-frameworks:title","isUnderCurrentDocsTree":false},{"name":"rails","route":"/openapi/frameworks/rails","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:24:frontMatter","title":"Ruby on Rails","type":"doc"}],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:frontMatter","title":"Frameworks","type":"doc"},{"name":"release-notes-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:0:data:release-notes-section:title","isUnderCurrentDocsTree":false},{"name":"release-notes","route":"/openapi/release-notes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:23:frontMatter","title":"OpenAPI Release Notes","type":"doc"},{"name":"pagination","route":"/openapi/pagination","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:24:frontMatter","title":"Pagination","type":"doc"}],"title":"OpenAPI Hub","type":"page","display":"children"},{"name":"api-design","route":"/api-design","children":[{"name":"search-bar-api-design","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:0:data:search-bar-api-design:title","isUnderCurrentDocsTree":false},{"name":"index","route":"/api-design","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:2:frontMatter","title":"Introduction","type":"doc"},{"name":"basics-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:0:data:basics-section:title","isUnderCurrentDocsTree":false},{"name":"picking-architectures","route":"/api-design/picking-architectures","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:4:frontMatter","title":"Picking an architecture","type":"doc"},{"name":"urls","route":"/api-design/urls","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:5:frontMatter","title":"Structuring URLs","type":"doc"},{"name":"http-methods","route":"/api-design/http-methods","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:6:frontMatter","title":"HTTP Methods","type":"doc"},{"name":"parameters","route":"/api-design/parameters","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:7:frontMatter","title":"Request parameters","type":"doc"},{"name":"data-formats","route":"/api-design/data-formats","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:8:frontMatter","title":"Data Formats","type":"doc"},{"name":"request-body","route":"/api-design/request-body","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:9:frontMatter","title":"Request Body","type":"doc"},{"name":"status-codes","route":"/api-design/status-codes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:10:frontMatter","title":"Status Codes","type":"doc"},{"name":"responses","route":"/api-design/responses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:11:frontMatter","title":"Response Body","type":"doc"},{"name":"advanced-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:0:data:advanced-section:title","isUnderCurrentDocsTree":false},{"name":"file-uploads","route":"/api-design/file-uploads","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:13:frontMatter","title":"File uploads","type":"doc"},{"name":"pagination","route":"/api-design/pagination","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:14:frontMatter","title":"Pagination","type":"doc"},{"name":"filtering-responses","route":"/api-design/filtering-responses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:15:frontMatter","title":"Filtering responses","type":"doc"},{"name":"caching","route":"/api-design/caching","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:16:frontMatter","title":"Caching","type":"doc"},{"name":"errors","route":"/api-design/errors","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:17:frontMatter","title":"Returning Errors","type":"doc"},{"name":"rate-limiting","route":"/api-design/rate-limiting","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:18:frontMatter","title":"Rate limiting","type":"doc"},{"name":"versioning","route":"/api-design/versioning","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:19:frontMatter","title":"Versioning","type":"doc"},{"name":"product-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:0:data:product-section:title","isUnderCurrentDocsTree":false},{"name":"expose-api-publicly","route":"/api-design/expose-api-publicly","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:21:frontMatter","title":"Expose APIs publicly","type":"doc"},{"name":"monetization","route":"/api-design/monetization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:22:frontMatter","title":"Monetizing APIs","type":"doc"},{"name":"developer-experience","route":"/api-design/developer-experience","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:23:frontMatter","title":"Developer experience","type":"doc"},{"name":"documentation","route":"/api-design/documentation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:24:frontMatter","title":"Documentation","type":"doc"},{"name":"consistency","route":"/api-design/consistency","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:25:frontMatter","title":"Enforcing consistency","type":"doc"},{"name":"security","route":"/api-design/security","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:26:frontMatter","title":"Security","type":"doc"},{"name":"api-compliance","route":"/api-design/api-compliance","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:27:frontMatter","title":"API Compliance","type":"doc"},{"name":"testing","route":"/api-design/testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:28:frontMatter","title":"Testing","type":"doc"},{"name":"collections","route":"/api-design/collections","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:29:frontMatter","title":"Collections","type":"doc"}],"title":"API Design","type":"page","display":"children"},{"name":"guides","route":"/guides","children":[{"name":"search-bar-guides","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:0:data:search-bar-guides:title","isUnderCurrentDocsTree":false},{"name":"index","route":"/guides","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:2:frontMatter","title":"Overview","type":"doc"},{"name":"openapi","route":"/guides/openapi","children":[{"name":"additionalproperties","route":"/guides/openapi/additionalproperties","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:3:children:1:frontMatter","title":"Understanding additionalProperties","type":"doc"},{"name":"x-codesamples","route":"/guides/openapi/x-codesamples","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:3:children:2:frontMatter","title":"Code Samples Extension","type":"doc"},{"name":"path-fragments","route":"/guides/openapi/path-fragments","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:3:children:3:frontMatter","title":"Path Fragments","type":"doc"},{"name":"publish-specs-to-api-registry","route":"/guides/openapi/publish-specs-to-api-registry","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:3:children:4:frontMatter","title":"Publish Specs to API Registry","type":"doc"}],"title":"OpenAPI Guides","type":"doc"},{"name":"sdks","route":"/guides/sdks","children":[{"name":"creating-a-monorepo","route":"/guides/sdks/creating-a-monorepo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:1:frontMatter","title":"Create a Monorepo","type":"doc"},{"name":"utilizing-user-agent-strings","route":"/guides/sdks/utilizing-user-agent-strings","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:2:frontMatter","title":"User Agent Strings","type":"doc"},{"name":"generate-in-a-subdirectory","route":"/guides/sdks/generate-in-a-subdirectory","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:3:frontMatter","title":"Generate in a Subdirectory","type":"doc"},{"name":"typescript-monorepo-tips","route":"/guides/sdks/typescript-monorepo-tips","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:4:frontMatter","title":"TypeScript Monorepo Tips","type":"doc"},{"name":"pnpm-default","route":"/guides/sdks/pnpm-default","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:5:frontMatter","title":"Using PNPM","type":"doc"},{"name":"override-compile","route":"/guides/sdks/override-compile","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:6:frontMatter","title":"Override Compile Commands","type":"doc"},{"name":"overlays","route":"/guides/sdks/overlays","children":[{"name":"overlays","route":"/guides/sdks/overlays/overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:7:children:1:frontMatter","title":"Common Overlays for SDKs","type":"doc"},{"name":"internal-external-versions","route":"/guides/sdks/overlays/internal-external-versions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:7:children:2:frontMatter","title":"Internal and External SDKs","type":"doc"},{"name":"json-path-expressions","route":"/guides/sdks/overlays/json-path-expressions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:7:children:3:frontMatter","title":"JSON Path Expressions","type":"doc"}],"title":"SDK Overlays","type":"doc"}],"title":"SDK Guides","type":"doc"},{"name":"hooks","route":"/guides/hooks","children":[{"name":"env-auth-hook","route":"/guides/hooks/env-auth-hook","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:5:children:1:frontMatter","title":"Environment Auth Hook","type":"doc"},{"name":"posthog-telemetry-hook","route":"/guides/hooks/posthog-telemetry-hook","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:5:children:2:frontMatter","title":"PostHog Telemetry Hook","type":"doc"},{"name":"sentry-error-hook","route":"/guides/hooks/sentry-error-hook","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:5:children:3:frontMatter","title":"Sentry Error Hook","type":"doc"},{"name":"user-agent-hook","route":"/guides/hooks/user-agent-hook","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:5:children:4:frontMatter","title":"User Agent Hook","type":"doc"}],"title":"Hook Guides","type":"doc"},{"name":"terraform","route":"/guides/terraform","children":[{"name":"crud","route":"/guides/terraform/crud","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:6:children:1:frontMatter","title":"CRUD Example","type":"doc"},{"name":"hoisting","route":"/guides/terraform/hoisting","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:6:children:2:frontMatter","title":"Hoisting","type":"doc"},{"name":"merged-entity","route":"/guides/terraform/merged-entity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:6:children:3:frontMatter","title":"Merged Entity","type":"doc"},{"name":"remove-nontf-endpoints","route":"/guides/terraform/remove-nontf-endpoints","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:6:children:4:frontMatter","title":"Remove Non-TF Endpoints","type":"doc"}],"title":"Terraform Guides","type":"doc"}],"title":"Guides","type":"page","display":"children"},{"name":"mcp","route":"/mcp","children":[{"name":"search-bar-mcp","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:0:data:search-bar-mcp:title","isUnderCurrentDocsTree":false},{"name":"index","route":"/mcp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:2:frontMatter","title":"MCP Hub","type":"doc"},{"name":"mcp-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:0:data:mcp-section:title","isUnderCurrentDocsTree":false},{"name":"intro","route":"/mcp/intro","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:4:frontMatter","title":"What is MCP?","type":"doc"},{"name":"mcp-tutorial","route":"/mcp/mcp-tutorial","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:5:frontMatter","title":"In-Depth MCP tutorial","type":"doc"},{"name":"tools","route":"/mcp/tools","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:6:frontMatter","title":"MCP Tools","type":"doc"},{"name":"resources","route":"/mcp/resources","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:7:frontMatter","title":"MCP Resources","type":"doc"},{"name":"prompts","route":"/mcp/prompts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:8:frontMatter","title":"MCP Prompts","type":"doc"},{"name":"sampling","route":"/mcp/sampling","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:9:frontMatter","title":"MCP Sampling","type":"doc"},{"name":"transports","route":"/mcp/transports","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:10:frontMatter","title":"MCP Transports","type":"doc"},{"name":"roots","route":"/mcp/roots","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:11:frontMatter","title":"MCP Roots","type":"doc"},{"name":"authorization","route":"/mcp/authorization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:12:frontMatter","title":"MCP Authorization","type":"doc"},{"name":"remote-servers","route":"/mcp/remote-servers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:13:frontMatter","title":"Example: MCP Remote Servers","type":"doc"},{"name":"optimizing-your-openapi-for-mcp","route":"/mcp/optimizing-your-openapi-for-mcp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:14:frontMatter","title":"Optimize OpenAPI for MCP","type":"doc"},{"name":"agents-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:0:data:agents-section:title","isUnderCurrentDocsTree":false},{"name":"ai-agents-intro","route":"/mcp/ai-agents-intro","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:16:frontMatter","title":"Introduction to AI Agents","type":"doc"},{"name":"agents-mcp-real-world-example","route":"/mcp/agents-mcp-real-world-example","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:17:frontMatter","title":"Building Agents with MCP","type":"doc"},{"name":"integrating-with-agents","route":"/mcp/integrating-with-agents","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:18:frontMatter","title":"How AI agents can improve your existing systems","type":"doc"},{"name":"architecture-of-agentic-applications","route":"/mcp/architecture-of-agentic-applications","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:19:frontMatter","title":"Architecture of Agentic Applications","type":"doc"},{"name":"release-notes-section","type":"separator","title":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:0:data:release-notes-section:title","isUnderCurrentDocsTree":false},{"name":"release-notes","route":"/mcp/release-notes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:21:frontMatter","title":"MCP Release Notes","type":"doc"}],"title":"MCP Hub","type":"page","display":"children"},"$5:0:props:activePath:0",{"name":"changelog","route":"/changelog","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:8:frontMatter","title":"Changelog","type":"page","display":"children"},{"name":"customers","route":"/customers","children":[{"name":"index","route":"/customers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:1:frontMatter","title":"Customers | Speakeasy","type":"doc"},{"name":"airbyte","route":"/customers/airbyte","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:2:frontMatter","title":"Offering a Terraform Provider and SDKs Accelerates Adoption and Improves Customer Experience","type":"doc"},{"name":"apex","route":"/customers/apex","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:3:frontMatter","title":"How a fintech with $123B of assets powers modern financial experiences through Speakeasy","type":"doc"},{"name":"apiture","route":"/customers/apiture","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:4:frontMatter","title":"Why Apiture Switched from OSS Generators to Speakeasy for High-Quality SDKs","type":"doc"},{"name":"codat","route":"/customers/codat","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:5:frontMatter","title":"How Codat Delivered Three Production-Ready SDKs in Two Weeks","type":"doc"},{"name":"conductorone","route":"/customers/conductorone","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:6:frontMatter","title":"ConductorOne Saves 650+ Hours of Development Time with Speakeasy","type":"doc"},{"name":"epilot","route":"/customers/epilot","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:7:frontMatter","title":"Automating Terraform Provider Creation Cuts Costs by 8X and Accelerates Go-to-Market","type":"doc"},{"name":"formance","route":"/customers/formance","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:8:frontMatter","title":"Formance Builds Open Source Fintech Infrastructure Supported by Speakeasy SDKs","type":"doc"},{"name":"kong","route":"/customers/kong","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:9:frontMatter","title":"A Terraform Provider for Kong in 120 Hours","type":"doc"},{"name":"mistral","route":"/customers/mistral","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:10:frontMatter","title":"How Mistral AI Scaled to Millions of SDK Downloads with Speakeasy","type":"doc"},{"name":"prove","route":"/customers/prove","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:11:frontMatter","title":"How Prove Accelerated Integration Speed with Automated SDKs","type":"doc"},{"name":"solarwinds","route":"/customers/solarwinds","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:12:frontMatter","title":"SolarWinds Accelerates API Integration with Speakeasy-Generated SDKs","type":"doc"},{"name":"unified","route":"/customers/unified","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:13:frontMatter","title":"Unified.to Builds Six SDKs in One Week — While Saving $450K","type":"doc"},{"name":"unstructured","route":"/customers/unstructured","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:14:frontMatter","title":"How Unstructured Makes Its Enterprise API More Accessible With Speakeasy","type":"doc"}],"title":"Customers","type":"page","display":"children"}],"docsDirectories":"$5:0:props:menuData","flatDocsDirectories":[{"name":"index","route":"/docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:2:frontMatter","title":"Home","type":"doc","isUnderCurrentDocsTree":false},{"name":"introduction","route":"/docs/introduction","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:3:frontMatter","title":"Introduction","type":"doc","isUnderCurrentDocsTree":false},{"name":"core-concepts","route":"/docs/core-concepts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:4:frontMatter","title":"Core Concepts","type":"doc","isUnderCurrentDocsTree":false},{"name":"create-client-sdks","route":"/docs/create-client-sdks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:6:frontMatter","title":"Generate SDKs","type":"doc","isUnderCurrentDocsTree":false},{"name":"best-practices","route":"/docs/prep-openapi/best-practices","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:0:frontMatter","title":"OpenAPI overview and best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"linting","route":"/docs/prep-openapi/linting","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:1:frontMatter","title":"OpenAPI document linting","type":"doc","isUnderCurrentDocsTree":false},{"name":"maintenance","route":"/docs/prep-openapi/maintenance","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:2:frontMatter","title":"Speakeasy Suggest","type":"doc","isUnderCurrentDocsTree":false},{"name":"apply-overlays","route":"/docs/prep-openapi/overlays/apply-overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:3:children:0:frontMatter","title":"Apply an overlay","type":"doc","isUnderCurrentDocsTree":false},{"name":"create-overlays","route":"/docs/prep-openapi/overlays/create-overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:3:children:1:frontMatter","title":"Create overlays","type":"doc","isUnderCurrentDocsTree":false},{"name":"transformations","route":"/docs/prep-openapi/transformations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:7:children:4:frontMatter","title":"Transformations","type":"doc","isUnderCurrentDocsTree":false},{"name":"basics","route":"/docs/customize/basics","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:1:frontMatter","title":"Customization Basics","type":"doc","isUnderCurrentDocsTree":false},{"name":"imports","route":"/docs/customize/structure/imports","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:2:children:0:frontMatter","title":"Customize imports","type":"doc","isUnderCurrentDocsTree":false},{"name":"namespaces","route":"/docs/customize/structure/namespaces","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:2:children:1:frontMatter","title":"Customize namespaces","type":"doc","isUnderCurrentDocsTree":false},{"name":"types","route":"/docs/customize/data-model/types","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:1:frontMatter","title":"Types","type":"doc","isUnderCurrentDocsTree":false},{"name":"enums","route":"/docs/customize/data-model/enums","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:2:frontMatter","title":"Enums","type":"doc","isUnderCurrentDocsTree":false},{"name":"oneof-schemas","route":"/docs/customize/data-model/oneof-schemas","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:3:frontMatter","title":"OneOf","type":"doc","isUnderCurrentDocsTree":false},{"name":"complex-numbers","route":"/docs/customize/data-model/complex-numbers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:3:children:4:frontMatter","title":"Complex Numbers","type":"doc","isUnderCurrentDocsTree":false},{"name":"methods","route":"/docs/customize/methods","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:4:frontMatter","title":"Customize methods","type":"doc","isUnderCurrentDocsTree":false},{"name":"responses","route":"/docs/customize/responses/responses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:5:children:1:frontMatter","title":"Customize Responses","type":"doc","isUnderCurrentDocsTree":false},{"name":"errors","route":"/docs/customize/responses/errors","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:5:children:2:frontMatter","title":"Error Handling","type":"doc","isUnderCurrentDocsTree":false},{"name":"globals","route":"/docs/customize/globals","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:6:frontMatter","title":"Global Parameters","type":"doc","isUnderCurrentDocsTree":false},{"name":"servers","route":"/docs/customize/servers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:7:frontMatter","title":"Configure servers","type":"doc","isUnderCurrentDocsTree":false},{"name":"deprecations","route":"/docs/customize/deprecations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:8:frontMatter","title":"Deprecations","type":"doc","isUnderCurrentDocsTree":false},{"name":"overview","route":"/docs/customize/authentication/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:1:frontMatter","title":"Overview","type":"doc","isUnderCurrentDocsTree":false},{"name":"configuration","route":"/docs/customize/authentication/configuration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:2:frontMatter","title":"Configuration Options","type":"doc","isUnderCurrentDocsTree":false},{"name":"simple-schemes","route":"/docs/customize/authentication/simple-schemes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:3:frontMatter","title":"Standard security schemes","type":"doc","isUnderCurrentDocsTree":false},{"name":"oauth","route":"/docs/customize/authentication/oauth","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:4:frontMatter","title":"OAuth 2.0 Authentication","type":"doc","isUnderCurrentDocsTree":false},{"name":"custom-security-schemes","route":"/docs/customize/authentication/custom-security-schemes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:5:frontMatter","title":"Custom Security Schemes","type":"doc","isUnderCurrentDocsTree":false},{"name":"security-callbacks","route":"/docs/customize/authentication/security-callbacks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:9:children:6:frontMatter","title":"Security Callbacks","type":"doc","isUnderCurrentDocsTree":false},{"name":"retries","route":"/docs/customize/runtime/retries","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:1:frontMatter","title":"Enable Retries","type":"doc","isUnderCurrentDocsTree":false},{"name":"timeouts","route":"/docs/customize/runtime/timeouts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:2:frontMatter","title":"Enable Timeouts","type":"doc","isUnderCurrentDocsTree":false},{"name":"pagination","route":"/docs/customize/runtime/pagination","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:3:frontMatter","title":"Enable Pagination","type":"doc","isUnderCurrentDocsTree":false},{"name":"streaming","route":"/docs/customize/runtime/streaming","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:4:frontMatter","title":"Enable Streaming","type":"doc","isUnderCurrentDocsTree":false},{"name":"server-sent-events","route":"/docs/customize/runtime/server-sent-events","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:5:frontMatter","title":"Enable Server-Sent Events","type":"doc","isUnderCurrentDocsTree":false},{"name":"jsonl-events","route":"/docs/customize/runtime/jsonl-events","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:6:frontMatter","title":"Enable JSON Lines Responses","type":"doc","isUnderCurrentDocsTree":false},{"name":"custom-http-client","route":"/docs/customize/runtime/custom-http-client","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:7:frontMatter","title":"Customize HTTP Client","type":"doc","isUnderCurrentDocsTree":false},{"name":"override-accept-headers","route":"/docs/customize/runtime/override-accept-headers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:10:children:8:frontMatter","title":"Override accept headers","type":"doc","isUnderCurrentDocsTree":false},{"name":"webhooks","route":"/docs/customize/webhooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:11:frontMatter","title":"Add webhooks to your SDKs","type":"doc","isUnderCurrentDocsTree":false},{"name":"overview","route":"/docs/customize/code/code-regions/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:1:frontMatter","title":"Custom code regions","type":"doc","isUnderCurrentDocsTree":false},{"name":"python","route":"/docs/customize/code/code-regions/python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:2:frontMatter","title":"Custom code regions in Python","type":"doc","isUnderCurrentDocsTree":false},{"name":"typescript","route":"/docs/customize/code/code-regions/typescript","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:3:frontMatter","title":"Custom code regions in TypeScript","type":"doc","isUnderCurrentDocsTree":false},{"name":"java","route":"/docs/customize/code/code-regions/java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:1:children:4:frontMatter","title":"Custom code regions in Java","type":"doc","isUnderCurrentDocsTree":false},{"name":"monkey-patching","route":"/docs/customize/code/monkey-patching","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:2:frontMatter","title":"Monkey patching","type":"doc","isUnderCurrentDocsTree":false},{"name":"sdk-hooks","route":"/docs/customize/code/sdk-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:12:children:3:frontMatter","title":"Custom code with SDK hooks","type":"doc","isUnderCurrentDocsTree":false},{"name":"additional-index-exports","route":"/docs/customize/typescript/additional-index-exports","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:0:frontMatter","title":"Additional index exports","type":"doc","isUnderCurrentDocsTree":false},{"name":"configuring-module-format","route":"/docs/customize/typescript/configuring-module-format","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:1:frontMatter","title":"Configuring module format","type":"doc","isUnderCurrentDocsTree":false},{"name":"disabling-barrel-files","route":"/docs/customize/typescript/disabling-barrel-files","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:2:frontMatter","title":"Disabling barrel files","type":"doc","isUnderCurrentDocsTree":false},{"name":"model-validation-and-serialization","route":"/docs/customize/typescript/model-validation-and-serialization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:3:frontMatter","title":"Model validation and serialization","type":"doc","isUnderCurrentDocsTree":false},{"name":"react-hooks","route":"/docs/customize/typescript/react-hooks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:8:children:13:children:4:frontMatter","title":"Generating React Hooks from OpenAPI/Swagger","type":"doc","isUnderCurrentDocsTree":false},{"name":"versioning","route":"/docs/manage/versioning","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:1:frontMatter","title":"Version Control","type":"doc","isUnderCurrentDocsTree":false},{"name":"github-setup","route":"/docs/manage/github-setup","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:2:frontMatter","title":"Github Setup","type":"doc","isUnderCurrentDocsTree":false},{"name":"sdk-sandbox","route":"/docs/manage/sdk-sandbox","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:3:frontMatter","title":"Enable Sandbox","type":"doc","isUnderCurrentDocsTree":false},{"name":"poetry-2-update","route":"/docs/manage/migrate/poetry-2-update","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:0:frontMatter","title":"Poetry 2.0 and Python 3.9 Updates","type":"doc","isUnderCurrentDocsTree":false},{"name":"python-migration","route":"/docs/manage/migrate/python-migration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:1:frontMatter","title":"Migrate from the Python v1 SDK","type":"doc","isUnderCurrentDocsTree":false},{"name":"workflow-migration","route":"/docs/manage/migrate/workflow-migration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:4:children:2:frontMatter","title":"Migrate to Speakeasy workflows","type":"doc","isUnderCurrentDocsTree":false},{"name":"forward-compatibility","route":"/docs/manage/forward-compatibility","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:5:frontMatter","title":"Forward Compatibility","type":"doc","isUnderCurrentDocsTree":false},{"name":"breaking-changes","route":"/docs/manage/breaking-changes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:9:children:6:frontMatter","title":"Handle Breaking Changes","type":"doc","isUnderCurrentDocsTree":false},{"name":"publish-sdk","route":"/docs/publish-sdk","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:10:frontMatter","title":"Publish SDK","type":"doc","isUnderCurrentDocsTree":false},{"name":"philosophy","route":"/docs/languages/philosophy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:1:frontMatter","title":"Design philosophy","type":"doc","isUnderCurrentDocsTree":false},{"name":"maturity","route":"/docs/languages/maturity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:2:frontMatter","title":"Maturity","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-ts","route":"/docs/languages/typescript/methodology-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:1:frontMatter","title":"TypeScript design","type":"doc","isUnderCurrentDocsTree":false},{"name":"oss-comparison-ts","route":"/docs/languages/typescript/oss-comparison-ts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":false},{"name":"migrating-from-oss","route":"/docs/languages/typescript/migrating-from-oss","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:3:frontMatter","title":"Migrating from OpenAPI Generator to Speakeasy","type":"doc","isUnderCurrentDocsTree":false},{"name":"feature-support","route":"/docs/languages/typescript/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:4:frontMatter","title":"Feature reference","type":"doc","isUnderCurrentDocsTree":false},{"name":"standalone-functions","route":"/docs/languages/typescript/standalone-functions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:3:children:5:frontMatter","title":"Standalone functions","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-python","route":"/docs/languages/python/methodology-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:1:frontMatter","title":"Python design","type":"doc","isUnderCurrentDocsTree":false},{"name":"oss-comparison-python","route":"/docs/languages/python/oss-comparison-python","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":false},{"name":"feature-support","route":"/docs/languages/python/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:4:children:3:frontMatter","title":"Feature reference","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-go","route":"/docs/languages/golang/methodology-go","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:1:frontMatter","title":"Go design","type":"doc","isUnderCurrentDocsTree":false},{"name":"oss-comparison-go","route":"/docs/languages/golang/oss-comparison-go","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":false},{"name":"feature-support","route":"/docs/languages/golang/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:5:children:3:frontMatter","title":"Feature reference","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-java","route":"/docs/languages/java/methodology-java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:1:frontMatter","title":"Java design","type":"doc","isUnderCurrentDocsTree":false},{"name":"oss-comparison-java","route":"/docs/languages/java/oss-comparison-java","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":false},{"name":"feature-support","route":"/docs/languages/java/feature-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:3:frontMatter","title":"Feature reference","type":"doc","isUnderCurrentDocsTree":false},{"name":"param-encoding","route":"/docs/languages/java/param-encoding","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:6:children:4:frontMatter","title":"Parameter encoding","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-csharp","route":"/docs/languages/csharp/methodology-csharp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:7:children:1:frontMatter","title":"C# design","type":"doc","isUnderCurrentDocsTree":false},{"name":"oss-comparison-csharp","route":"/docs/languages/csharp/oss-comparison-csharp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:7:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-php","route":"/docs/languages/php/methodology-php","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:8:children:1:frontMatter","title":"PHP design","type":"doc","isUnderCurrentDocsTree":false},{"name":"oss-comparison-php","route":"/docs/languages/php/oss-comparison-php","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:8:children:2:frontMatter","title":"Speakeasy vs. OSS generators","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-ruby","route":"/docs/languages/ruby/methodology-ruby","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:9:children:1:frontMatter","title":"Ruby design [coming soon]","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-rust","route":"/docs/languages/rust/methodology-rust","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:10:children:1:frontMatter","title":"Rust design [coming soon]","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-cpp","route":"/docs/languages/cpp/methodology-cpp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:11:children:1:frontMatter","title":"C++ design [coming soon]","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-unity","route":"/docs/languages/unity/methodology-unity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:12:children:1:frontMatter","title":"Unity design [coming soon]","type":"doc","isUnderCurrentDocsTree":false},{"name":"methodology-swift","route":"/docs/languages/swift/methodology-swift","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:11:children:13:children:0:frontMatter","title":"Create Swift SDKs from OpenAPI / Swagger","type":"doc","isUnderCurrentDocsTree":false},{"name":"model-context-protocol","route":"/docs/model-context-protocol","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:13:frontMatter","title":"Generate MCP servers","type":"doc","isUnderCurrentDocsTree":false},{"name":"custom-mcp-tools-resources","route":"/docs/model-context-protocol/custom-mcp-tools-resources","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:13:children:0:frontMatter","title":"Custom MCP Server Extensions","type":"doc","isUnderCurrentDocsTree":false},{"name":"create-terraform","route":"/docs/create-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:15:frontMatter","title":"Generate Terraform Provider","type":"doc","isUnderCurrentDocsTree":false},{"name":"publish-terraform","route":"/docs/publish-terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:16:frontMatter","title":"Publish Terraform Provider","type":"doc","isUnderCurrentDocsTree":false},{"name":"index","route":"/docs/terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:1:frontMatter","title":"Overview","type":"doc","isUnderCurrentDocsTree":false},{"name":"entity-mapping","route":"/docs/terraform/entity-mapping","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:2:frontMatter","title":"Map API Entities","type":"doc","isUnderCurrentDocsTree":false},{"name":"property-customization","route":"/docs/terraform/property-customization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:3:frontMatter","title":"Property Customization","type":"doc","isUnderCurrentDocsTree":false},{"name":"validation-dependencies","route":"/docs/terraform/validation-dependencies","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:4:frontMatter","title":"Validation and Dependencies","type":"doc","isUnderCurrentDocsTree":false},{"name":"plan-modification","route":"/docs/terraform/plan-modification","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:5:frontMatter","title":"Plan Modification","type":"doc","isUnderCurrentDocsTree":false},{"name":"configuration","route":"/docs/terraform/configuration","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:6:frontMatter","title":"Configuration","type":"doc","isUnderCurrentDocsTree":false},{"name":"advanced-features","route":"/docs/terraform/advanced-features","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:7:frontMatter","title":"Advanced Features","type":"doc","isUnderCurrentDocsTree":false},{"name":"schema-keywords","route":"/docs/terraform/schema-keywords","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:17:children:8:frontMatter","title":"Schema Keywords","type":"doc","isUnderCurrentDocsTree":false},{"name":"testing","route":"/docs/testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:19:frontMatter","title":"Start Testing","type":"doc","isUnderCurrentDocsTree":false},{"name":"bootstrapping-test-generation","route":"/docs/customize-testing/bootstrapping-test-generation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:0:frontMatter","title":"Bootstrapping SDK Tests","type":"doc","isUnderCurrentDocsTree":false},{"name":"customizing-sdk-tests","route":"/docs/customize-testing/customizing-sdk-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:1:frontMatter","title":"Customizing SDK Tests","type":"doc","isUnderCurrentDocsTree":false},{"name":"github-actions","route":"/docs/customize-testing/github-actions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:2:frontMatter","title":"Testing in GitHub Actions","type":"doc","isUnderCurrentDocsTree":false},{"name":"openapi-in-tests","route":"/docs/customize-testing/openapi-in-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:3:frontMatter","title":"OpenAPI Data in Tests","type":"doc","isUnderCurrentDocsTree":false},{"name":"running-tests","route":"/docs/customize-testing/running-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:20:children:4:frontMatter","title":"Running SDK Tests","type":"doc","isUnderCurrentDocsTree":false},{"name":"api-contract-tests","route":"/docs/api-contract-tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:21:frontMatter","title":"Configure Custom API Contract Tests","type":"doc","isUnderCurrentDocsTree":false},{"name":"sdk-docs","route":"/docs/sdk-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:23:frontMatter","title":"Customize SDK Documentation","type":"doc","isUnderCurrentDocsTree":false},{"name":"automated-code-sample-urls","route":"/docs/code-samples/automated-code-sample-urls","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:0:frontMatter","title":"Automated code sample URLs","type":"doc","isUnderCurrentDocsTree":false},{"name":"code-samples-api","route":"/docs/code-samples/code-samples-api","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:1:frontMatter","title":"The Code Samples API","type":"doc","isUnderCurrentDocsTree":false},{"name":"generate-code-samples","route":"/docs/code-samples/generate-code-samples","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:24:children:2:frontMatter","title":"Generating code samples for your SDK","type":"doc","isUnderCurrentDocsTree":false},{"name":"_get-public-url-snippet","route":"/docs/integrations/_get-public-url-snippet","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:0:frontMatter","title":" Get Public URL Snippet","type":"doc","isUnderCurrentDocsTree":false},{"name":"bump","route":"/docs/integrations/bump","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:1:frontMatter","title":"Integrate Speakeasy with Bump.sh","type":"doc","isUnderCurrentDocsTree":false},{"name":"mintlify","route":"/docs/integrations/mintlify","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:2:frontMatter","title":"Integrate Speakeasy with Mintlify","type":"doc","isUnderCurrentDocsTree":false},{"name":"readme","route":"/docs/integrations/readme","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:3:frontMatter","title":"Integrate Speakeasy with ReadMe","type":"doc","isUnderCurrentDocsTree":false},{"name":"scalar","route":"/docs/integrations/scalar","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:25:children:4:frontMatter","title":"Integrate Speakeasy with Scalar","type":"doc","isUnderCurrentDocsTree":false},{"name":"overview","route":"/docs/snippet-ai/overview","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:1:frontMatter","title":"Overview","type":"doc","isUnderCurrentDocsTree":false},{"name":"integrate-via-react","route":"/docs/snippet-ai/integrate-via-react","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:2:frontMatter","title":"Integrate via React","type":"doc","isUnderCurrentDocsTree":false},{"name":"integrate-via-web-component","route":"/docs/snippet-ai/integrate-via-web-component","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:3:frontMatter","title":"Integrate via Web Component","type":"doc","isUnderCurrentDocsTree":false},{"name":"integrate-via-script","route":"/docs/snippet-ai/integrate-via-script","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:26:children:4:frontMatter","title":"Integrate via Script","type":"doc","isUnderCurrentDocsTree":false},{"name":"cli","route":"/docs/speakeasy-reference/cli","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:frontMatter","title":"CLI","type":"doc","isUnderCurrentDocsTree":false},{"name":"getting-started","route":"/docs/speakeasy-reference/cli/getting-started","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:1:frontMatter","title":"Getting Started","type":"doc","isUnderCurrentDocsTree":false},{"name":"mise-toolkit","route":"/docs/speakeasy-reference/cli/mise-toolkit","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:2:frontMatter","title":"Using with mise toolkit","type":"doc","isUnderCurrentDocsTree":false},{"name":"ask","route":"/docs/speakeasy-reference/cli/ask","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:3:frontMatter","title":"ask","type":"doc","isUnderCurrentDocsTree":false},{"name":"auth","route":"/docs/speakeasy-reference/cli/auth","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:4:frontMatter","title":"auth","type":"doc","isUnderCurrentDocsTree":false},{"name":"login","route":"/docs/speakeasy-reference/cli/auth/login","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:4:children:0:frontMatter","title":"login","type":"doc","isUnderCurrentDocsTree":false},{"name":"logout","route":"/docs/speakeasy-reference/cli/auth/logout","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:4:children:1:frontMatter","title":"logout","type":"doc","isUnderCurrentDocsTree":false},{"name":"switch","route":"/docs/speakeasy-reference/cli/auth/switch","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:4:children:2:frontMatter","title":"switch","type":"doc","isUnderCurrentDocsTree":false},{"name":"billing","route":"/docs/speakeasy-reference/cli/billing","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:5:frontMatter","title":"billing","type":"doc","isUnderCurrentDocsTree":false},{"name":"activate","route":"/docs/speakeasy-reference/cli/billing/activate","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:5:children:0:frontMatter","title":"activate","type":"doc","isUnderCurrentDocsTree":false},{"name":"bump","route":"/docs/speakeasy-reference/cli/bump","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:6:frontMatter","title":"bump","type":"doc","isUnderCurrentDocsTree":false},{"name":"clean","route":"/docs/speakeasy-reference/cli/clean","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:7:frontMatter","title":"clean","type":"doc","isUnderCurrentDocsTree":false},{"name":"configure","route":"/docs/speakeasy-reference/cli/configure","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:frontMatter","title":"configure","type":"doc","isUnderCurrentDocsTree":false},{"name":"github","route":"/docs/speakeasy-reference/cli/configure/github","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:children:0:frontMatter","title":"github","type":"doc","isUnderCurrentDocsTree":false},{"name":"publishing","route":"/docs/speakeasy-reference/cli/configure/publishing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:children:1:frontMatter","title":"publishing","type":"doc","isUnderCurrentDocsTree":false},{"name":"sources","route":"/docs/speakeasy-reference/cli/configure/sources","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:children:2:frontMatter","title":"sources","type":"doc","isUnderCurrentDocsTree":false},{"name":"targets","route":"/docs/speakeasy-reference/cli/configure/targets","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:children:3:frontMatter","title":"targets","type":"doc","isUnderCurrentDocsTree":false},{"name":"tests","route":"/docs/speakeasy-reference/cli/configure/tests","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:8:children:4:frontMatter","title":"tests","type":"doc","isUnderCurrentDocsTree":false},{"name":"lint","route":"/docs/speakeasy-reference/cli/lint","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:9:frontMatter","title":"lint","type":"doc","isUnderCurrentDocsTree":false},{"name":"arazzo","route":"/docs/speakeasy-reference/cli/lint/arazzo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:9:children:0:frontMatter","title":"arazzo","type":"doc","isUnderCurrentDocsTree":false},{"name":"config","route":"/docs/speakeasy-reference/cli/lint/config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:9:children:1:frontMatter","title":"config","type":"doc","isUnderCurrentDocsTree":false},{"name":"openapi","route":"/docs/speakeasy-reference/cli/lint/openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:9:children:2:frontMatter","title":"openapi","type":"doc","isUnderCurrentDocsTree":false},{"name":"merge","route":"/docs/speakeasy-reference/cli/merge","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:10:frontMatter","title":"merge","type":"doc","isUnderCurrentDocsTree":false},{"name":"openapi","route":"/docs/speakeasy-reference/cli/openapi","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:frontMatter","title":"openapi","type":"doc","isUnderCurrentDocsTree":false},{"name":"diff","route":"/docs/speakeasy-reference/cli/openapi/diff","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:0:frontMatter","title":"diff","type":"doc","isUnderCurrentDocsTree":false},{"name":"lint","route":"/docs/speakeasy-reference/cli/openapi/lint","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:1:frontMatter","title":"lint","type":"doc","isUnderCurrentDocsTree":false},{"name":"transform","route":"/docs/speakeasy-reference/cli/openapi/transform","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:frontMatter","title":"transform","type":"doc","isUnderCurrentDocsTree":false},{"name":"cleanup","route":"/docs/speakeasy-reference/cli/openapi/transform/cleanup","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:0:frontMatter","title":"cleanup","type":"doc","isUnderCurrentDocsTree":false},{"name":"convert-swagger","route":"/docs/speakeasy-reference/cli/openapi/transform/convert-swagger","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:1:frontMatter","title":"convert-swagger","type":"doc","isUnderCurrentDocsTree":false},{"name":"filter-operations","route":"/docs/speakeasy-reference/cli/openapi/transform/filter-operations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:2:frontMatter","title":"filter-operations","type":"doc","isUnderCurrentDocsTree":false},{"name":"format","route":"/docs/speakeasy-reference/cli/openapi/transform/format","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:3:frontMatter","title":"format","type":"doc","isUnderCurrentDocsTree":false},{"name":"normalize","route":"/docs/speakeasy-reference/cli/openapi/transform/normalize","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:4:frontMatter","title":"normalize","type":"doc","isUnderCurrentDocsTree":false},{"name":"remove-unused","route":"/docs/speakeasy-reference/cli/openapi/transform/remove-unused","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:11:children:2:children:5:frontMatter","title":"remove-unused","type":"doc","isUnderCurrentDocsTree":false},{"name":"overlay","route":"/docs/speakeasy-reference/cli/overlay","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:12:frontMatter","title":"overlay","type":"doc","isUnderCurrentDocsTree":false},{"name":"apply","route":"/docs/speakeasy-reference/cli/overlay/apply","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:12:children:0:frontMatter","title":"apply","type":"doc","isUnderCurrentDocsTree":false},{"name":"compare","route":"/docs/speakeasy-reference/cli/overlay/compare","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:12:children:1:frontMatter","title":"compare","type":"doc","isUnderCurrentDocsTree":false},{"name":"validate","route":"/docs/speakeasy-reference/cli/overlay/validate","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:12:children:2:frontMatter","title":"validate","type":"doc","isUnderCurrentDocsTree":false},{"name":"quickstart","route":"/docs/speakeasy-reference/cli/quickstart","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:13:frontMatter","title":"quickstart","type":"doc","isUnderCurrentDocsTree":false},{"name":"run","route":"/docs/speakeasy-reference/cli/run","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:14:frontMatter","title":"run","type":"doc","isUnderCurrentDocsTree":false},{"name":"status","route":"/docs/speakeasy-reference/cli/status","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:15:frontMatter","title":"status","type":"doc","isUnderCurrentDocsTree":false},{"name":"suggest","route":"/docs/speakeasy-reference/cli/suggest","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:16:frontMatter","title":"suggest","type":"doc","isUnderCurrentDocsTree":false},{"name":"error-types","route":"/docs/speakeasy-reference/cli/suggest/error-types","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:16:children:0:frontMatter","title":"error-types","type":"doc","isUnderCurrentDocsTree":false},{"name":"operation-ids","route":"/docs/speakeasy-reference/cli/suggest/operation-ids","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:16:children:1:frontMatter","title":"operation-ids","type":"doc","isUnderCurrentDocsTree":false},{"name":"tag","route":"/docs/speakeasy-reference/cli/tag","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:17:frontMatter","title":"tag","type":"doc","isUnderCurrentDocsTree":false},{"name":"apply","route":"/docs/speakeasy-reference/cli/tag/apply","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:17:children:0:frontMatter","title":"apply","type":"doc","isUnderCurrentDocsTree":false},{"name":"promote","route":"/docs/speakeasy-reference/cli/tag/promote","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:17:children:1:frontMatter","title":"promote","type":"doc","isUnderCurrentDocsTree":false},{"name":"test","route":"/docs/speakeasy-reference/cli/test","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:18:frontMatter","title":"test","type":"doc","isUnderCurrentDocsTree":false},{"name":"update","route":"/docs/speakeasy-reference/cli/update","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:1:children:19:frontMatter","title":"update","type":"doc","isUnderCurrentDocsTree":false},{"name":"gen-yaml","route":"/docs/speakeasy-reference/generation/gen-yaml","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:1:frontMatter","title":"Config File","type":"doc","isUnderCurrentDocsTree":false},{"name":"ci-cd-pipeline","route":"/docs/speakeasy-reference/generation/ci-cd-pipeline","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:2:frontMatter","title":"CI/CD Pipeline","type":"doc","isUnderCurrentDocsTree":false},{"name":"ts-config","route":"/docs/speakeasy-reference/generation/ts-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:3:frontMatter","title":"TypeScript Configuration","type":"doc","isUnderCurrentDocsTree":false},{"name":"python-config","route":"/docs/speakeasy-reference/generation/python-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:4:frontMatter","title":"Python Configuration","type":"doc","isUnderCurrentDocsTree":false},{"name":"go-config","route":"/docs/speakeasy-reference/generation/go-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:5:frontMatter","title":"Go Configuration","type":"doc","isUnderCurrentDocsTree":false},{"name":"java-config","route":"/docs/speakeasy-reference/generation/java-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:6:frontMatter","title":"Java Configuration","type":"doc","isUnderCurrentDocsTree":false},{"name":"csharp-config","route":"/docs/speakeasy-reference/generation/csharp-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:7:frontMatter","title":"C# Configuration","type":"doc","isUnderCurrentDocsTree":false},{"name":"php-config","route":"/docs/speakeasy-reference/generation/php-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:8:frontMatter","title":"PHP Configuration","type":"doc","isUnderCurrentDocsTree":false},{"name":"ruby-config","route":"/docs/speakeasy-reference/generation/ruby-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:9:frontMatter","title":"Ruby Configuration","type":"doc","isUnderCurrentDocsTree":false},{"name":"swift-config","route":"/docs/speakeasy-reference/generation/swift-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:10:frontMatter","title":"Swift Configuration","type":"doc","isUnderCurrentDocsTree":false},{"name":"terraform-config","route":"/docs/speakeasy-reference/generation/terraform-config","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:2:children:11:frontMatter","title":"Terraform Configuration","type":"doc","isUnderCurrentDocsTree":false},{"name":"extensions","route":"/docs/speakeasy-reference/extensions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:3:frontMatter","title":"Speakeasy extensions","type":"doc","isUnderCurrentDocsTree":false},{"name":"workflow-file","route":"/docs/speakeasy-reference/workflow-file","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:28:children:4:frontMatter","title":"Speakeasy Workflow File","type":"doc","isUnderCurrentDocsTree":false},{"name":"openapi","route":"/docs/supported/openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:0:frontMatter","title":"OpenAPI Support Matrix","type":"doc","isUnderCurrentDocsTree":false},{"name":"terraform","route":"/docs/supported/terraform","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:29:children:1:frontMatter","title":"Speakeasy Terraform provider support matrix","type":"doc","isUnderCurrentDocsTree":false},{"name":"enterprise-support","route":"/docs/enterprise-support","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:32:frontMatter","title":"Enterprise Support","type":"doc","isUnderCurrentDocsTree":false},{"name":"product-security","route":"/docs/product-security","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:34:frontMatter","title":"Product Security","type":"doc","isUnderCurrentDocsTree":false},{"name":"privacy-policy","route":"/docs/privacy-policy","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:35:frontMatter","title":"Privacy Policy","type":"doc","isUnderCurrentDocsTree":false},{"name":"terms-of-service","route":"/docs/terms-of-service","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:36:frontMatter","title":"Terms of Service","type":"doc","isUnderCurrentDocsTree":false},{"name":"code-samples-without-github-actions","route":"/docs/guides/code-samples-without-github-actions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:2:children:37:children:0:frontMatter","title":"Using the CLI to populate code samples without GitHub Actions","type":"doc","isUnderCurrentDocsTree":false},{"name":"index","route":"/openapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:2:frontMatter","title":"Introduction","type":"doc","isUnderCurrentDocsTree":false},{"name":"info","route":"/openapi/info","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:3:frontMatter","title":"Info","type":"doc","isUnderCurrentDocsTree":false},{"name":"servers","route":"/openapi/servers","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:4:frontMatter","title":"Servers","type":"doc","isUnderCurrentDocsTree":false},{"name":"server-variables","route":"/openapi/servers/server-variables","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:4:children:0:frontMatter","title":"Server Variables in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"security","route":"/openapi/security","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:frontMatter","title":"Security","type":"doc","isUnderCurrentDocsTree":false},{"name":"custom-auth","route":"/openapi/security/custom-auth","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:0:frontMatter","title":"Custom Security Schemes in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"index","route":"/openapi/security/security-schemes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:0:frontMatter","title":"Security Schemes in OpenAPI","type":"doc","isUnderCurrentDocsTree":false},{"name":"security-api-key","route":"/openapi/security/security-schemes/security-api-key","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:1:frontMatter","title":"API Key in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"security-http","route":"/openapi/security/security-schemes/security-http","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:2:frontMatter","title":"HTTP Basic in OpenAPI","type":"doc","isUnderCurrentDocsTree":false},{"name":"security-mutualtls","route":"/openapi/security/security-schemes/security-mutualtls","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:3:frontMatter","title":"MutualTLS in OpenAPI","type":"doc","isUnderCurrentDocsTree":false},{"name":"security-oauth2","route":"/openapi/security/security-schemes/security-oauth2","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:4:frontMatter","title":"OAuth 2.0 in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"security-openid","route":"/openapi/security/security-schemes/security-openid","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:5:children:1:children:5:frontMatter","title":"OpenID Connect in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"paths","route":"/openapi/paths","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:6:frontMatter","title":"Paths","type":"doc","isUnderCurrentDocsTree":false},{"name":"operations","route":"/openapi/operations","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:7:frontMatter","title":"Operations","type":"doc","isUnderCurrentDocsTree":false},{"name":"content","route":"/openapi/content","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:8:frontMatter","title":"Content & Media","type":"doc","isUnderCurrentDocsTree":false},{"name":"file-uploads","route":"/openapi/content/file-uploads","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:8:children:1:frontMatter","title":"File Uploads","type":"doc","isUnderCurrentDocsTree":false},{"name":"server-sent-events","route":"/openapi/content/server-sent-events","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:8:children:2:frontMatter","title":"Server-Sent Events","type":"doc","isUnderCurrentDocsTree":false},{"name":"jsonl","route":"/openapi/content/jsonl","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:8:children:3:frontMatter","title":"JSONL","type":"doc","isUnderCurrentDocsTree":false},{"name":"schemas","route":"/openapi/schemas","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:frontMatter","title":"Data Types","type":"doc","isUnderCurrentDocsTree":false},{"name":"arrays","route":"/openapi/schemas/arrays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:0:frontMatter","title":"Arrays in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"booleans","route":"/openapi/schemas/booleans","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:1:frontMatter","title":"Booleans in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"composition","route":"/openapi/schemas/composition","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:2:frontMatter","title":"Schema Composition","type":"doc","isUnderCurrentDocsTree":false},{"name":"enums","route":"/openapi/schemas/enums","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:3:frontMatter","title":"Enums in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"null","route":"/openapi/schemas/null","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:4:frontMatter","title":"Null in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"numbers","route":"/openapi/schemas/numbers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:5:frontMatter","title":"Numbers and Integers in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"objects","route":"/openapi/schemas/objects","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:6:frontMatter","title":"Objects in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"polymorphism","route":"/openapi/schemas/objects/polymorphism","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:6:children:0:frontMatter","title":"oneOf, allOf, anyOf","type":"doc","isUnderCurrentDocsTree":false},{"name":"xml","route":"/openapi/schemas/objects/xml","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:6:children:1:frontMatter","title":"XML Objects","type":"doc","isUnderCurrentDocsTree":false},{"name":"strings","route":"/openapi/schemas/strings","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:9:children:7:frontMatter","title":"Strings in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"requests","route":"/openapi/requests","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:frontMatter","title":"Requests","type":"doc","isUnderCurrentDocsTree":false},{"name":"parameters","route":"/openapi/requests/parameters","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:children:0:frontMatter","title":"Request Parameters in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"cookie-parameters","route":"/openapi/requests/parameters/cookie-parameters","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:children:0:children:0:frontMatter","title":"Cookie Parameters in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"header-parameters","route":"/openapi/requests/parameters/header-parameters","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:children:0:children:1:frontMatter","title":"Header Parameters in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"path-parameters","route":"/openapi/requests/parameters/path-parameters","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:children:0:children:2:frontMatter","title":"Path Parameters in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"query-parameters","route":"/openapi/requests/parameters/query-parameters","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:10:children:0:children:3:frontMatter","title":"Query Parameters in OpenAPI best practices","type":"doc","isUnderCurrentDocsTree":false},{"name":"responses","route":"/openapi/responses","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:frontMatter","title":"Responses","type":"doc","isUnderCurrentDocsTree":false},{"name":"errors","route":"/openapi/responses/errors","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:children:1:frontMatter","title":"Errors","type":"doc","isUnderCurrentDocsTree":false},{"name":"rate-limiting","route":"/openapi/responses/rate-limiting","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:children:2:frontMatter","title":"Rate Limiting","type":"doc","isUnderCurrentDocsTree":false},{"name":"headers","route":"/openapi/responses/headers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:children:3:frontMatter","title":"Headers","type":"doc","isUnderCurrentDocsTree":false},{"name":"links","route":"/openapi/responses/links","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:children:4:frontMatter","title":"Links","type":"doc","isUnderCurrentDocsTree":false},{"name":"retries","route":"/openapi/responses/retries","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:11:children:5:frontMatter","title":"Retries","type":"doc","isUnderCurrentDocsTree":false},{"name":"components","route":"/openapi/components","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:12:frontMatter","title":"Components","type":"doc","isUnderCurrentDocsTree":false},{"name":"tags","route":"/openapi/tags","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:13:frontMatter","title":"Tags","type":"doc","isUnderCurrentDocsTree":false},{"name":"external-documentation","route":"/openapi/external-documentation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:14:frontMatter","title":"External Documentation","type":"doc","isUnderCurrentDocsTree":false},{"name":"references","route":"/openapi/references","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:15:frontMatter","title":"References ($ref)","type":"doc","isUnderCurrentDocsTree":false},{"name":"examples","route":"/openapi/examples","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:16:frontMatter","title":"Examples","type":"doc","isUnderCurrentDocsTree":false},{"name":"extensions","route":"/openapi/extensions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:17:frontMatter","title":"Extensions","type":"doc","isUnderCurrentDocsTree":false},{"name":"overlays","route":"/openapi/overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:18:frontMatter","title":"Overlays","type":"doc","isUnderCurrentDocsTree":false},{"name":"webhooks","route":"/openapi/webhooks","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:19:frontMatter","title":"Webhooks","type":"doc","isUnderCurrentDocsTree":false},{"name":"callbacks","route":"/openapi/webhooks/callbacks","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:19:children:0:frontMatter","title":"Callbacks","type":"doc","isUnderCurrentDocsTree":false},{"name":"arazzo","route":"/openapi/arazzo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:20:frontMatter","title":"Arazzo","type":"doc","isUnderCurrentDocsTree":false},{"name":"frameworks","route":"/openapi/frameworks","children":[],"frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:frontMatter","title":"Frameworks","type":"doc","isUnderCurrentDocsTree":false},{"name":"nestjs","route":"/openapi/frameworks/nestjs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:2:frontMatter","title":"NestJS","type":"doc","isUnderCurrentDocsTree":false},{"name":"fastify","route":"/openapi/frameworks/fastify","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:3:frontMatter","title":"Fastify","type":"doc","isUnderCurrentDocsTree":false},{"name":"hono","route":"/openapi/frameworks/hono","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:4:frontMatter","title":"Hono","type":"doc","isUnderCurrentDocsTree":false},{"name":"trpc","route":"/openapi/frameworks/trpc","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:5:frontMatter","title":"tRPC","type":"doc","isUnderCurrentDocsTree":false},{"name":"tsoa","route":"/openapi/frameworks/tsoa","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:6:frontMatter","title":"tsoa","type":"doc","isUnderCurrentDocsTree":false},{"name":"typespec","route":"/openapi/frameworks/typespec","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:7:frontMatter","title":"TypeSpec","type":"doc","isUnderCurrentDocsTree":false},{"name":"elysia","route":"/openapi/frameworks/elysia","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:8:frontMatter","title":"Elysia","type":"doc","isUnderCurrentDocsTree":false},{"name":"zod","route":"/openapi/frameworks/zod","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:9:frontMatter","title":"Zod","type":"doc","isUnderCurrentDocsTree":false},{"name":"fastapi","route":"/openapi/frameworks/fastapi","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:11:frontMatter","title":"FastAPI","type":"doc","isUnderCurrentDocsTree":false},{"name":"django","route":"/openapi/frameworks/django","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:12:frontMatter","title":"Django","type":"doc","isUnderCurrentDocsTree":false},{"name":"flask","route":"/openapi/frameworks/flask","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:13:frontMatter","title":"Flask","type":"doc","isUnderCurrentDocsTree":false},{"name":"pydantic","route":"/openapi/frameworks/pydantic","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:14:frontMatter","title":"Pydantic","type":"doc","isUnderCurrentDocsTree":false},{"name":"goa","route":"/openapi/frameworks/goa","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:16:frontMatter","title":"Goa","type":"doc","isUnderCurrentDocsTree":false},{"name":"grpc-gateway","route":"/openapi/frameworks/grpc-gateway","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:17:frontMatter","title":"gRPC-Gateway","type":"doc","isUnderCurrentDocsTree":false},{"name":"gnostic","route":"/openapi/frameworks/gnostic","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:18:frontMatter","title":"Gnostic","type":"doc","isUnderCurrentDocsTree":false},{"name":"springboot","route":"/openapi/frameworks/springboot","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:20:frontMatter","title":"Spring Boot","type":"doc","isUnderCurrentDocsTree":false},{"name":"laravel","route":"/openapi/frameworks/laravel","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:22:frontMatter","title":"Laravel","type":"doc","isUnderCurrentDocsTree":false},{"name":"rails","route":"/openapi/frameworks/rails","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:21:children:24:frontMatter","title":"Ruby on Rails","type":"doc","isUnderCurrentDocsTree":false},{"name":"release-notes","route":"/openapi/release-notes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:23:frontMatter","title":"OpenAPI Release Notes","type":"doc","isUnderCurrentDocsTree":false},{"name":"pagination","route":"/openapi/pagination","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:3:children:24:frontMatter","title":"Pagination","type":"doc","isUnderCurrentDocsTree":false},{"name":"index","route":"/api-design","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:2:frontMatter","title":"Introduction","type":"doc","isUnderCurrentDocsTree":false},{"name":"picking-architectures","route":"/api-design/picking-architectures","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:4:frontMatter","title":"Picking an architecture","type":"doc","isUnderCurrentDocsTree":false},{"name":"urls","route":"/api-design/urls","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:5:frontMatter","title":"Structuring URLs","type":"doc","isUnderCurrentDocsTree":false},{"name":"http-methods","route":"/api-design/http-methods","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:6:frontMatter","title":"HTTP Methods","type":"doc","isUnderCurrentDocsTree":false},{"name":"parameters","route":"/api-design/parameters","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:7:frontMatter","title":"Request parameters","type":"doc","isUnderCurrentDocsTree":false},{"name":"data-formats","route":"/api-design/data-formats","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:8:frontMatter","title":"Data Formats","type":"doc","isUnderCurrentDocsTree":false},{"name":"request-body","route":"/api-design/request-body","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:9:frontMatter","title":"Request Body","type":"doc","isUnderCurrentDocsTree":false},{"name":"status-codes","route":"/api-design/status-codes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:10:frontMatter","title":"Status Codes","type":"doc","isUnderCurrentDocsTree":false},{"name":"responses","route":"/api-design/responses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:11:frontMatter","title":"Response Body","type":"doc","isUnderCurrentDocsTree":false},{"name":"file-uploads","route":"/api-design/file-uploads","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:13:frontMatter","title":"File uploads","type":"doc","isUnderCurrentDocsTree":false},{"name":"pagination","route":"/api-design/pagination","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:14:frontMatter","title":"Pagination","type":"doc","isUnderCurrentDocsTree":false},{"name":"filtering-responses","route":"/api-design/filtering-responses","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:15:frontMatter","title":"Filtering responses","type":"doc","isUnderCurrentDocsTree":false},{"name":"caching","route":"/api-design/caching","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:16:frontMatter","title":"Caching","type":"doc","isUnderCurrentDocsTree":false},{"name":"errors","route":"/api-design/errors","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:17:frontMatter","title":"Returning Errors","type":"doc","isUnderCurrentDocsTree":false},{"name":"rate-limiting","route":"/api-design/rate-limiting","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:18:frontMatter","title":"Rate limiting","type":"doc","isUnderCurrentDocsTree":false},{"name":"versioning","route":"/api-design/versioning","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:19:frontMatter","title":"Versioning","type":"doc","isUnderCurrentDocsTree":false},{"name":"expose-api-publicly","route":"/api-design/expose-api-publicly","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:21:frontMatter","title":"Expose APIs publicly","type":"doc","isUnderCurrentDocsTree":false},{"name":"monetization","route":"/api-design/monetization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:22:frontMatter","title":"Monetizing APIs","type":"doc","isUnderCurrentDocsTree":false},{"name":"developer-experience","route":"/api-design/developer-experience","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:23:frontMatter","title":"Developer experience","type":"doc","isUnderCurrentDocsTree":false},{"name":"documentation","route":"/api-design/documentation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:24:frontMatter","title":"Documentation","type":"doc","isUnderCurrentDocsTree":false},{"name":"consistency","route":"/api-design/consistency","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:25:frontMatter","title":"Enforcing consistency","type":"doc","isUnderCurrentDocsTree":false},{"name":"security","route":"/api-design/security","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:26:frontMatter","title":"Security","type":"doc","isUnderCurrentDocsTree":false},{"name":"api-compliance","route":"/api-design/api-compliance","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:27:frontMatter","title":"API Compliance","type":"doc","isUnderCurrentDocsTree":false},{"name":"testing","route":"/api-design/testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:28:frontMatter","title":"Testing","type":"doc","isUnderCurrentDocsTree":false},{"name":"collections","route":"/api-design/collections","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:4:children:29:frontMatter","title":"Collections","type":"doc","isUnderCurrentDocsTree":false},{"name":"index","route":"/guides","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:2:frontMatter","title":"Overview","type":"doc","isUnderCurrentDocsTree":false},{"name":"additionalproperties","route":"/guides/openapi/additionalproperties","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:3:children:1:frontMatter","title":"Understanding additionalProperties","type":"doc","isUnderCurrentDocsTree":false},{"name":"x-codesamples","route":"/guides/openapi/x-codesamples","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:3:children:2:frontMatter","title":"Code Samples Extension","type":"doc","isUnderCurrentDocsTree":false},{"name":"path-fragments","route":"/guides/openapi/path-fragments","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:3:children:3:frontMatter","title":"Path Fragments","type":"doc","isUnderCurrentDocsTree":false},{"name":"publish-specs-to-api-registry","route":"/guides/openapi/publish-specs-to-api-registry","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:3:children:4:frontMatter","title":"Publish Specs to API Registry","type":"doc","isUnderCurrentDocsTree":false},{"name":"creating-a-monorepo","route":"/guides/sdks/creating-a-monorepo","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:1:frontMatter","title":"Create a Monorepo","type":"doc","isUnderCurrentDocsTree":false},{"name":"utilizing-user-agent-strings","route":"/guides/sdks/utilizing-user-agent-strings","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:2:frontMatter","title":"User Agent Strings","type":"doc","isUnderCurrentDocsTree":false},{"name":"generate-in-a-subdirectory","route":"/guides/sdks/generate-in-a-subdirectory","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:3:frontMatter","title":"Generate in a Subdirectory","type":"doc","isUnderCurrentDocsTree":false},{"name":"typescript-monorepo-tips","route":"/guides/sdks/typescript-monorepo-tips","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:4:frontMatter","title":"TypeScript Monorepo Tips","type":"doc","isUnderCurrentDocsTree":false},{"name":"pnpm-default","route":"/guides/sdks/pnpm-default","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:5:frontMatter","title":"Using PNPM","type":"doc","isUnderCurrentDocsTree":false},{"name":"override-compile","route":"/guides/sdks/override-compile","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:6:frontMatter","title":"Override Compile Commands","type":"doc","isUnderCurrentDocsTree":false},{"name":"overlays","route":"/guides/sdks/overlays/overlays","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:7:children:1:frontMatter","title":"Common Overlays for SDKs","type":"doc","isUnderCurrentDocsTree":false},{"name":"internal-external-versions","route":"/guides/sdks/overlays/internal-external-versions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:7:children:2:frontMatter","title":"Internal and External SDKs","type":"doc","isUnderCurrentDocsTree":false},{"name":"json-path-expressions","route":"/guides/sdks/overlays/json-path-expressions","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:4:children:7:children:3:frontMatter","title":"JSON Path Expressions","type":"doc","isUnderCurrentDocsTree":false},{"name":"env-auth-hook","route":"/guides/hooks/env-auth-hook","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:5:children:1:frontMatter","title":"Environment Auth Hook","type":"doc","isUnderCurrentDocsTree":false},{"name":"posthog-telemetry-hook","route":"/guides/hooks/posthog-telemetry-hook","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:5:children:2:frontMatter","title":"PostHog Telemetry Hook","type":"doc","isUnderCurrentDocsTree":false},{"name":"sentry-error-hook","route":"/guides/hooks/sentry-error-hook","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:5:children:3:frontMatter","title":"Sentry Error Hook","type":"doc","isUnderCurrentDocsTree":false},{"name":"user-agent-hook","route":"/guides/hooks/user-agent-hook","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:5:children:4:frontMatter","title":"User Agent Hook","type":"doc","isUnderCurrentDocsTree":false},{"name":"crud","route":"/guides/terraform/crud","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:6:children:1:frontMatter","title":"CRUD Example","type":"doc","isUnderCurrentDocsTree":false},{"name":"hoisting","route":"/guides/terraform/hoisting","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:6:children:2:frontMatter","title":"Hoisting","type":"doc","isUnderCurrentDocsTree":false},{"name":"merged-entity","route":"/guides/terraform/merged-entity","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:6:children:3:frontMatter","title":"Merged Entity","type":"doc","isUnderCurrentDocsTree":false},{"name":"remove-nontf-endpoints","route":"/guides/terraform/remove-nontf-endpoints","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:5:children:6:children:4:frontMatter","title":"Remove Non-TF Endpoints","type":"doc","isUnderCurrentDocsTree":false},{"name":"index","route":"/mcp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:2:frontMatter","title":"MCP Hub","type":"doc","isUnderCurrentDocsTree":false},{"name":"intro","route":"/mcp/intro","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:4:frontMatter","title":"What is MCP?","type":"doc","isUnderCurrentDocsTree":false},{"name":"mcp-tutorial","route":"/mcp/mcp-tutorial","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:5:frontMatter","title":"In-Depth MCP tutorial","type":"doc","isUnderCurrentDocsTree":false},{"name":"tools","route":"/mcp/tools","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:6:frontMatter","title":"MCP Tools","type":"doc","isUnderCurrentDocsTree":false},{"name":"resources","route":"/mcp/resources","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:7:frontMatter","title":"MCP Resources","type":"doc","isUnderCurrentDocsTree":false},{"name":"prompts","route":"/mcp/prompts","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:8:frontMatter","title":"MCP Prompts","type":"doc","isUnderCurrentDocsTree":false},{"name":"sampling","route":"/mcp/sampling","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:9:frontMatter","title":"MCP Sampling","type":"doc","isUnderCurrentDocsTree":false},{"name":"transports","route":"/mcp/transports","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:10:frontMatter","title":"MCP Transports","type":"doc","isUnderCurrentDocsTree":false},{"name":"roots","route":"/mcp/roots","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:11:frontMatter","title":"MCP Roots","type":"doc","isUnderCurrentDocsTree":false},{"name":"authorization","route":"/mcp/authorization","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:12:frontMatter","title":"MCP Authorization","type":"doc","isUnderCurrentDocsTree":false},{"name":"remote-servers","route":"/mcp/remote-servers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:13:frontMatter","title":"Example: MCP Remote Servers","type":"doc","isUnderCurrentDocsTree":false},{"name":"optimizing-your-openapi-for-mcp","route":"/mcp/optimizing-your-openapi-for-mcp","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:14:frontMatter","title":"Optimize OpenAPI for MCP","type":"doc","isUnderCurrentDocsTree":false},{"name":"ai-agents-intro","route":"/mcp/ai-agents-intro","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:16:frontMatter","title":"Introduction to AI Agents","type":"doc","isUnderCurrentDocsTree":false},{"name":"agents-mcp-real-world-example","route":"/mcp/agents-mcp-real-world-example","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:17:frontMatter","title":"Building Agents with MCP","type":"doc","isUnderCurrentDocsTree":false},{"name":"integrating-with-agents","route":"/mcp/integrating-with-agents","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:18:frontMatter","title":"How AI agents can improve your existing systems","type":"doc","isUnderCurrentDocsTree":false},{"name":"architecture-of-agentic-applications","route":"/mcp/architecture-of-agentic-applications","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:19:frontMatter","title":"Architecture of Agentic Applications","type":"doc","isUnderCurrentDocsTree":false},{"name":"release-notes","route":"/mcp/release-notes","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:6:children:21:frontMatter","title":"MCP Release Notes","type":"doc","isUnderCurrentDocsTree":false},"$5:0:props:menuData:0","$5:0:props:menuData:1","$5:0:props:menuData:2","$5:0:props:menuData:3","$5:0:props:menuData:4","$5:0:props:menuData:5","$5:0:props:menuData:6","$5:0:props:menuData:7","$5:0:props:menuData:8","$5:0:props:menuData:9","$5:0:props:menuData:10","$5:0:props:menuData:11","$5:0:props:menuData:12","$5:0:props:menuData:13","$5:0:props:menuData:14","$5:0:props:menuData:15","$5:0:props:menuData:16","$5:0:props:menuData:17","$5:0:props:menuData:18","$5:0:props:menuData:19","$5:0:props:menuData:20","$5:0:props:menuData:21","$5:0:props:menuData:22","$5:0:props:menuData:23","$5:0:props:menuData:24","$5:0:props:menuData:25","$5:0:props:menuData:26","$5:0:props:menuData:27","$5:0:props:menuData:28","$5:0:props:menuData:29","$5:0:props:menuData:30","$5:0:props:menuData:31","$5:0:props:menuData:32","$5:0:props:menuData:33","$5:0:props:menuData:34","$5:0:props:menuData:35","$5:0:props:menuData:36","$5:0:props:menuData:37","$5:0:props:menuData:38","$5:0:props:menuData:39","$5:0:props:menuData:40","$5:0:props:menuData:41","$5:0:props:menuData:42","$5:0:props:menuData:43","$5:0:props:menuData:44","$5:0:props:menuData:45","$5:0:props:menuData:46","$5:0:props:menuData:47","$5:0:props:menuData:48","$5:0:props:menuData:49","$5:0:props:menuData:50","$5:0:props:menuData:51","$5:0:props:menuData:52","$5:0:props:menuData:53","$5:0:props:menuData:54","$5:0:props:menuData:55","$5:0:props:menuData:56","$5:0:props:menuData:57","$5:0:props:menuData:58","$5:0:props:menuData:59","$5:0:props:menuData:60","$5:0:props:menuData:61","$5:0:props:menuData:62","$5:0:props:menuData:63","$5:0:props:menuData:64","$5:0:props:menuData:65","$5:0:props:menuData:66","$5:0:props:menuData:67","$5:0:props:menuData:68","$5:0:props:menuData:69","$5:0:props:menuData:70","$5:0:props:menuData:71","$5:0:props:menuData:72","$5:0:props:menuData:73","$5:0:props:menuData:74","$5:0:props:menuData:75","$5:0:props:menuData:76","$5:0:props:menuData:77","$5:0:props:menuData:78","$5:0:props:menuData:79","$5:0:props:menuData:80","$5:0:props:menuData:81","$5:0:props:menuData:82","$5:0:props:menuData:83","$5:0:props:menuData:84","$5:0:props:menuData:85","$5:0:props:menuData:86","$5:0:props:menuData:87","$5:0:props:menuData:88","$5:0:props:menuData:89","$5:0:props:menuData:90","$5:0:props:menuData:91","$5:0:props:menuData:92","$5:0:props:menuData:93","$5:0:props:menuData:94","$5:0:props:menuData:95","$5:0:props:menuData:96","$5:0:props:menuData:97","$5:0:props:menuData:98","$5:0:props:menuData:99","$5:0:props:menuData:100","$5:0:props:menuData:101","$5:0:props:menuData:102","$5:0:props:menuData:103","$5:0:props:menuData:104","$5:0:props:menuData:105","$5:0:props:menuData:106","$5:0:props:menuData:107","$5:0:props:menuData:108","$5:0:props:menuData:109","$5:0:props:menuData:110","$5:0:props:menuData:111","$5:0:props:menuData:112","$5:0:props:menuData:113","$5:0:props:menuData:114","$5:0:props:menuData:115","$5:0:props:menuData:116","$5:0:props:menuData:117","$5:0:props:menuData:118","$5:0:props:menuData:119","$5:0:props:menuData:120","$5:0:props:menuData:121","$5:0:props:menuData:122","$5:0:props:menuData:123","$5:0:props:menuData:124","$5:0:props:menuData:125","$5:0:props:menuData:126","$5:0:props:menuData:127","$5:0:props:menuData:128","$5:0:props:menuData:129","$5:0:props:menuData:130","$5:0:props:menuData:131","$5:0:props:menuData:132","$5:0:props:menuData:133","$5:0:props:menuData:134","$5:0:props:menuData:135","$5:0:props:menuData:136","$5:0:props:menuData:137","$5:0:props:menuData:138","$5:0:props:menuData:139","$5:0:props:menuData:140","$5:0:props:menuData:141","$5:0:props:menuData:142","$5:0:props:menuData:143","$5:0:props:menuData:144","$5:0:props:menuData:145","$5:0:props:menuData:146","$5:0:props:menuData:147","$5:0:props:menuData:148","$5:0:props:menuData:149","$5:0:props:menuData:150","$5:0:props:menuData:151","$5:0:props:menuData:152","$5:0:props:menuData:153","$5:0:props:menuData:154","$5:0:props:menuData:155","$5:0:props:menuData:156","$5:0:props:menuData:157","$5:0:props:menuData:158","$5:0:props:menuData:159",{"name":"index","route":"/customers","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:1:frontMatter","title":"Customers | Speakeasy","type":"doc","isUnderCurrentDocsTree":false},{"name":"airbyte","route":"/customers/airbyte","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:2:frontMatter","title":"Offering a Terraform Provider and SDKs Accelerates Adoption and Improves Customer Experience","type":"doc","isUnderCurrentDocsTree":false},{"name":"apex","route":"/customers/apex","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:3:frontMatter","title":"How a fintech with $123B of assets powers modern financial experiences through Speakeasy","type":"doc","isUnderCurrentDocsTree":false},{"name":"apiture","route":"/customers/apiture","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:4:frontMatter","title":"Why Apiture Switched from OSS Generators to Speakeasy for High-Quality SDKs","type":"doc","isUnderCurrentDocsTree":false},{"name":"codat","route":"/customers/codat","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:5:frontMatter","title":"How Codat Delivered Three Production-Ready SDKs in Two Weeks","type":"doc","isUnderCurrentDocsTree":false},{"name":"conductorone","route":"/customers/conductorone","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:6:frontMatter","title":"ConductorOne Saves 650+ Hours of Development Time with Speakeasy","type":"doc","isUnderCurrentDocsTree":false},{"name":"epilot","route":"/customers/epilot","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:7:frontMatter","title":"Automating Terraform Provider Creation Cuts Costs by 8X and Accelerates Go-to-Market","type":"doc","isUnderCurrentDocsTree":false},{"name":"formance","route":"/customers/formance","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:8:frontMatter","title":"Formance Builds Open Source Fintech Infrastructure Supported by Speakeasy SDKs","type":"doc","isUnderCurrentDocsTree":false},{"name":"kong","route":"/customers/kong","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:9:frontMatter","title":"A Terraform Provider for Kong in 120 Hours","type":"doc","isUnderCurrentDocsTree":false},{"name":"mistral","route":"/customers/mistral","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:10:frontMatter","title":"How Mistral AI Scaled to Millions of SDK Downloads with Speakeasy","type":"doc","isUnderCurrentDocsTree":false},{"name":"prove","route":"/customers/prove","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:11:frontMatter","title":"How Prove Accelerated Integration Speed with Automated SDKs","type":"doc","isUnderCurrentDocsTree":false},{"name":"solarwinds","route":"/customers/solarwinds","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:12:frontMatter","title":"SolarWinds Accelerates API Integration with Speakeasy-Generated SDKs","type":"doc","isUnderCurrentDocsTree":false},{"name":"unified","route":"/customers/unified","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:13:frontMatter","title":"Unified.to Builds Six SDKs in One Week — While Saving $450K","type":"doc","isUnderCurrentDocsTree":false},{"name":"unstructured","route":"/customers/unstructured","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:9:children:14:frontMatter","title":"How Unstructured Makes Its Enterprise API More Accessible With Speakeasy","type":"doc","isUnderCurrentDocsTree":false},{"name":"api-docs","route":"/product/api-docs","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:17:children:0:frontMatter","title":"API Docs | Speakeasy","type":"doc","isUnderCurrentDocsTree":true},{"name":"api-testing","route":"/product/api-testing","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:17:children:1:frontMatter","title":"API Testing | Speakeasy","type":"doc","isUnderCurrentDocsTree":true},{"name":"mcp-server","route":"/product/mcp-server","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:17:children:2:frontMatter","title":"MCP Server Generator | Speakeasy","type":"doc","isUnderCurrentDocsTree":true},{"name":"react-query","route":"/product/react-query","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:17:children:3:frontMatter","title":"React Query Hooks | Speakeasy","type":"doc","isUnderCurrentDocsTree":true},{"name":"index","route":"/product/sdk-generation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:17:children:4:children:0:frontMatter","title":"SDK Generation | Speakeasy","type":"doc","isUnderCurrentDocsTree":true},{"name":"internal","route":"/product/sdk-generation/internal","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:17:children:4:children:1:frontMatter","title":"Internal developer portal for your APIs | Speakeasy","type":"doc","isUnderCurrentDocsTree":true},{"name":"terraform-generation","route":"/product/terraform-generation","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:17:children:5:frontMatter","title":"Terraform Generation | Speakeasy","type":"doc","isUnderCurrentDocsTree":true},{"name":"2025","route":"/state-of-api-devex/2025","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:18:children:0:frontMatter","title":"State of API DevEx Survey | Speakeasy","type":"doc","isUnderCurrentDocsTree":true}],"topLevelNavbarItems":[{"name":"docs","route":"/docs","children":["$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:0","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:1","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:2","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:3","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:4","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:5","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:6","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:7","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:8","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:9","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:10","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:11","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:12","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:13","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:14","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:15","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:16","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:17","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:18","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:19","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:20","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:21","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:22","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:23","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:24","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:25","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:26","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:27","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:28","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:29","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:30","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:31","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:32","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:33","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:34","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:35","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:0:children:36"],"title":"Documentation","type":"page","display":"children","firstChildRoute":"/docs"},{"name":"openapi","route":"/openapi","children":["$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:0","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:1","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:2","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:3","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:4","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:5","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:6","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:7","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:8","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:9","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:10","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:11","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:12","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:13","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:14","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:15","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:16","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:17","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:18","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:19","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:20","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:21","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:22","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:1:children:23"],"title":"OpenAPI Hub","type":"page","display":"children","firstChildRoute":"/openapi"},{"name":"api-design","route":"/api-design","children":["$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:0","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:1","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:2","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:3","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:4","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:5","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:6","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:7","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:8","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:9","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:10","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:11","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:12","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:13","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:14","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:15","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:16","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:17","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:18","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:19","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:20","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:21","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:22","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:23","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:24","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:25","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:26","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:27","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:2:children:28"],"title":"API Design","type":"page","display":"children","firstChildRoute":"/api-design"},{"name":"guides","route":"/guides","children":["$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:3:children:0","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:3:children:1","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:3:children:2","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:3:children:3","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:3:children:4","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:3:children:5"],"title":"Guides","type":"page","display":"children","firstChildRoute":"/guides"},{"name":"mcp","route":"/mcp","children":["$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:0","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:1","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:2","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:3","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:4","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:5","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:6","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:7","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:8","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:9","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:10","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:11","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:12","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:13","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:14","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:15","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:16","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:17","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:18","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:19","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:4:children:20"],"title":"MCP Hub","type":"page","display":"children","firstChildRoute":"/mcp"},{"name":"blog","route":"/blog","children":["$5:0:props:activePath:0:children:0","$5:0:props:activePath:0:children:1","$5:0:props:activePath:0:children:2","$5:0:props:activePath:0:children:3","$5:0:props:activePath:0:children:4","$5:0:props:activePath:0:children:5","$5:0:props:activePath:0:children:6","$5:0:props:activePath:0:children:7","$5:0:props:activePath:0:children:8","$5:0:props:activePath:0:children:9","$5:0:props:activePath:0:children:10","$5:0:props:activePath:0:children:11","$5:0:props:activePath:0:children:12","$5:0:props:activePath:0:children:13","$5:0:props:activePath:0:children:14","$5:0:props:activePath:0:children:15","$5:0:props:activePath:0:children:16","$5:0:props:activePath:0:children:17","$5:0:props:activePath:0:children:18","$5:0:props:activePath:0:children:19","$5:0:props:activePath:0:children:20","$5:0:props:activePath:0:children:21","$5:0:props:activePath:0:children:22","$5:0:props:activePath:0:children:23","$5:0:props:activePath:0:children:24","$5:0:props:activePath:0:children:25","$5:0:props:activePath:0:children:26","$5:0:props:activePath:0:children:27","$5:0:props:activePath:0:children:28","$5:0:props:activePath:0:children:29","$5:0:props:activePath:0:children:30","$5:0:props:activePath:0:children:31","$5:0:props:activePath:0:children:32","$5:0:props:activePath:0:children:33","$5:0:props:activePath:0:children:34","$5:0:props:activePath:0:children:35","$5:0:props:activePath:0:children:36","$5:0:props:activePath:0:children:37","$5:0:props:activePath:0:children:38","$5:0:props:activePath:0:children:39","$5:0:props:activePath:0:children:40","$5:0:props:activePath:0:children:41","$5:0:props:activePath:0:children:42","$5:0:props:activePath:0:children:43","$5:0:props:activePath:0:children:44","$5:0:props:activePath:0:children:45","$5:0:props:activePath:0:children:46","$5:0:props:activePath:0:children:47","$5:0:props:activePath:0:children:48","$5:0:props:activePath:0:children:49","$5:0:props:activePath:0:children:50","$5:0:props:activePath:0:children:51","$5:0:props:activePath:0:children:52","$5:0:props:activePath:0:children:53","$5:0:props:activePath:0:children:54","$5:0:props:activePath:0:children:55","$5:0:props:activePath:0:children:56","$5:0:props:activePath:0:children:57","$5:0:props:activePath:0:children:58","$5:0:props:activePath:0:children:59","$5:0:props:activePath:0:children:60","$5:0:props:activePath:0:children:61","$5:0:props:activePath:0:children:62","$5:0:props:activePath:0:children:63","$5:0:props:activePath:0:children:64","$5:0:props:activePath:0:children:65","$5:0:props:activePath:0:children:66","$5:0:props:activePath:0:children:67","$5:0:props:activePath:0:children:68","$5:0:props:activePath:0:children:69","$5:0:props:activePath:0:children:70","$5:0:props:activePath:0:children:71","$5:0:props:activePath:0:children:72","$5:0:props:activePath:0:children:73","$5:0:props:activePath:0:children:74","$5:0:props:activePath:0:children:75","$5:0:props:activePath:0:children:76","$5:0:props:activePath:0:children:77","$5:0:props:activePath:0:children:78","$5:0:props:activePath:0:children:79","$5:0:props:activePath:0:children:80","$5:0:props:activePath:0:children:81","$5:0:props:activePath:0:children:82","$5:0:props:activePath:0:children:83","$5:0:props:activePath:0:children:84","$5:0:props:activePath:0:children:85","$5:0:props:activePath:0:children:86","$5:0:props:activePath:0:children:87","$5:0:props:activePath:0:children:88","$5:0:props:activePath:0:children:89","$5:0:props:activePath:0:children:90","$5:0:props:activePath:0:children:91","$5:0:props:activePath:0:children:92","$5:0:props:activePath:0:children:93","$5:0:props:activePath:0:children:94","$5:0:props:activePath:0:children:95","$5:0:props:activePath:0:children:96","$5:0:props:activePath:0:children:97","$5:0:props:activePath:0:children:98","$5:0:props:activePath:0:children:99","$5:0:props:activePath:0:children:100","$5:0:props:activePath:0:children:101","$5:0:props:activePath:0:children:102","$5:0:props:activePath:0:children:103","$5:0:props:activePath:0:children:104","$5:0:props:activePath:0:children:105","$5:0:props:activePath:0:children:106","$5:0:props:activePath:0:children:107","$5:0:props:activePath:0:children:108","$5:0:props:activePath:0:children:109","$5:0:props:activePath:0:children:110","$5:0:props:activePath:0:children:111","$5:0:props:activePath:0:children:112","$5:0:props:activePath:0:children:113","$5:0:props:activePath:0:children:114","$5:0:props:activePath:0:children:115","$5:0:props:activePath:0:children:116","$5:0:props:activePath:0:children:117","$5:0:props:activePath:0:children:118","$5:0:props:activePath:0:children:119","$5:0:props:activePath:0:children:120","$5:0:props:activePath:0:children:121","$5:0:props:activePath:0:children:122","$5:0:props:activePath:0:children:123","$5:0:props:activePath:0:children:124","$5:0:props:activePath:0:children:125","$5:0:props:activePath:0:children:126","$5:0:props:activePath:0:children:127","$5:0:props:activePath:0:children:128","$5:0:props:activePath:0:children:129","$5:0:props:activePath:0:children:130","$5:0:props:activePath:0:children:131","$5:0:props:activePath:0:children:132","$5:0:props:activePath:0:children:133","$5:0:props:activePath:0:children:134","$5:0:props:activePath:0:children:135","$5:0:props:activePath:0:children:136","$5:0:props:activePath:0:children:137","$5:0:props:activePath:0:children:138","$5:0:props:activePath:0:children:139","$5:0:props:activePath:0:children:140","$5:0:props:activePath:0:children:141","$5:0:props:activePath:0:children:142","$5:0:props:activePath:0:children:143","$5:0:props:activePath:0:children:144","$5:0:props:activePath:0:children:145","$5:0:props:activePath:0:children:146","$5:0:props:activePath:0:children:147","$5:0:props:activePath:0:children:148","$5:0:props:activePath:0:children:149","$5:0:props:activePath:0:children:150","$5:0:props:activePath:0:children:151","$5:0:props:activePath:0:children:152","$5:0:props:activePath:0:children:153","$5:0:props:activePath:0:children:154","$5:0:props:activePath:0:children:155","$5:0:props:activePath:0:children:156","$5:0:props:activePath:0:children:157","$5:0:props:activePath:0:children:158","$5:0:props:activePath:0:children:159"],"title":"Blog","type":"page","display":"children","firstChildRoute":"/blog"},{"name":"changelog","route":"/changelog","frontMatter":"$4:props:children:props:children:props:children:props:children:1:props:children:props:children:props:children:2:props:children:props:children:2:props:pageMap:8:frontMatter","title":"Changelog","type":"page","display":"children"},{"name":"customers","route":"/customers","children":["$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:0","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:1","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:2","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:3","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:4","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:5","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:6","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:7","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:8","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:9","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:10","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:11","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:12","$5:1:props:children:props:children:1:props:children:1:props:children:0:props:content:directories:7:children:13"],"title":"Customers","type":"page","display":"children","firstChildRoute":"/customers"}]}}],false,[["$","div",null,{"className":"callout contrast-more:border-current! my-6 flex gap-x-2 rounded-lg border py-2 pe-4 border-blue-100 bg-blue-50 [&_.text-body]:text-blue-800 text-blue-800 dark:border-blue-200/30 dark:bg-blue-900/30 dark:text-blue-200 dark:[&_.text-body]:text-blue-200 [&_a]:text-blue-600 dark:[&_a]:text-blue-200 [&_a:hover]:text-blue-600 dark:[&_a:hover]:text-blue-100","children":[["$","div",null,{"className":"ps-3 pe-2 text-xl select-none","data-pagefind-ignore":"all","style":{"fontFamily":"\"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\""},"children":"ℹ️"}],["$","div",null,{"className":"w-full min-w-0 leading-7","children":[["$","strong",null,{"children":"NOTE"}],["$","$L25",null,{"as":"p","children":"This comparison of Speakeasy and Fern is based on a snapshot of two developing\ncompanies as of January 2025. If you think we need to update this post, please\nlet us know!"}]]}]]}],"\n",["$","$L25",null,{"as":"p","children":[["$","a",null,{"href":"https://www.speakeasy.com/","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["Speakeasy",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," and ",["$","a",null,{"href":"https://buildwithfern.com/","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["Fern",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," both offer free and paid services that API developers use to create SDKs (client libraries) and automate SDKs’ publication to package managers, but how do they differ? Here’s the short answer:"]}],"\n",["$","ol",null,{"className":"list-decimal [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","strong",null,{"children":"Fern"}]," is an SDK generation tool designed for the Fern domain-specific language (DSL). It creates SDKs in seven languages and API reference documentation."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","strong",null,{"children":"Speakeasy"}]," is a complete platform for building and exposing enterprise APIs. It is OpenAPI-native and supports SDK generation in ten languages, as well as Terraform providers and documentation."]}],"\n"]}],"\n",["$","h2",null,{"id":"how-is-speakeasy-different","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["How is Speakeasy different?",["$","$L26",null,{"id":"how-is-speakeasy-different"}]]}],"\n",["$","h3",null,{"id":"speakeasy-is-everything-you-need-in-one","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Speakeasy is everything you need in one",["$","$L26",null,{"id":"speakeasy-is-everything-you-need-in-one"}]]}],"\n",["$","$L25",null,{"as":"p","children":"We’ve built a platform that does more than merely generate SDKs. You could use Fern for SDKs, Stoplight for documentation, Spectral for linting, and handroll your Terraform provider, or you could use Speakeasy to do it all. One platform, one team, all your API needs handled."}],"\n",["$","h3",null,{"id":"openapi-native-vs-openapi-compatible","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["OpenAPI-native vs OpenAPI-compatible",["$","$L26",null,{"id":"openapi-native-vs-openapi-compatible"}]]}],"\n",["$","$L25",null,{"as":"p","children":["Speakeasy is designed to be ",["$","strong",null,{"children":"OpenAPI-native"}],". We don’t believe the world needs another standard for describing APIs. OpenAPI has its flaws, but it’s the established standard, and we’re committed to making it better. That means that Speakeasy is interoperable with the rest of the API tooling ecosystem. Mix and match us with your other favorite tools, and we’ll play nice."]}],"\n",["$","$L25",null,{"as":"p","children":["Fern is built on top of a ",["$","a",null,{"href":"https://buildwithfern.com/learn/api-definition/fern/overview","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["DSL (domain-specific language)",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],", with ",["$","strong",null,{"children":"optional"}]," support for OpenAPI. This makes Fern ",["$","strong",null,{"children":"OpenAPI-compatible"}],", meaning your OpenAPI document is no longer the single source of truth for your API."]}],"\n",["$","h3",null,{"id":"engineering-velocity-and-maturity","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Engineering velocity and maturity",["$","$L26",null,{"id":"engineering-velocity-and-maturity"}]]}],"\n",["$","$L25",null,{"as":"p","children":["Fern’s initial GitHub commit was in ",["$","a",null,{"href":"https://github.com/fern-api/fern/commit/322908f557ee94882ed64f265993ed53ae002198","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["April 2022",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],", and the tool has expanded its language support to seven languages since then. By comparison, ",["$","a",null,{"href":"https://github.com/speakeasy-api/speakeasy/commit/cb126d57ba7ad2ed9c1445a396beb5b48714da80","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["Speakeasy’s first commit was in September 2022",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],", and the platform has released support for ten languages in a shorter period."]}],"\n",["$","$L25",null,{"as":"p","children":["The Speakeasy platform is also broader, with support for additional generation features not supported by Fern, like ",["$","$L27",null,{"href":"/post/release-react-hooks","prefetch":"$undefined","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":"React Hooks"}]," and ",["$","$L27",null,{"href":"/post/release-terraform-v2","prefetch":"$undefined","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":"Terraform providers"}],"."]}],"\n",["$","h3",null,{"id":"speakeasy-sdks-work-where-you-need-them","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Speakeasy SDKs work where you need them",["$","$L26",null,{"id":"speakeasy-sdks-work-where-you-need-them"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Speakeasy SDKs are designed to work in any environment. Speakeasy supports the latest versions of the languages it targets, and we’re committed to staying up to date with new releases. Our TypeScript SDKs can be bundled for the browser and many other JavaScript environments, while Fern’s are Node.js-only."}],"\n",["$","$L25",null,{"as":"p","children":"Speakeasy gets high-quality products in the hands of our users fast."}],"\n",["$","h2",null,{"id":"comparing-speakeasy-and-fern","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Comparing Speakeasy and Fern",["$","$L26",null,{"id":"comparing-speakeasy-and-fern"}]]}],"\n",["$","h3",null,{"id":"sdk-generation","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["SDK generation",["$","$L26",null,{"id":"sdk-generation"}]]}],"\n",["$","$L25",null,{"as":"p","children":["Everyone has that one odd language that is critically important to their business and seemingly to nobody else’s. That’s why we’re committed to supporting the long tail. We’ve made a dent, but we’ve got further to go. Is there a language you need that we don’t support? ",["$","a",null,{"href":"https://go.speakeasy.com/slack","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["Join our Slack community",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," to let us know."]}],"\n",["$","$L28",null,{"title":"SDK Generation Support","columns":[{"key":"language","header":"Language"},{"key":"speakeasy","header":"Speakeasy"},{"key":"fern","header":"Fern"}],"data":[{"language":"Go","speakeasy":"✅","fern":"✅"},{"language":"Python","speakeasy":"✅","fern":"✅"},{"language":"TypeScript","speakeasy":"✅","fern":"✅"},{"language":"Java","speakeasy":"✅","fern":"✅"},{"language":"C#","speakeasy":"✅","fern":"✅"},{"language":"PHP","speakeasy":"✅","fern":"✅"},{"language":"Ruby","speakeasy":"✅","fern":"✅"},{"language":"Terraform","speakeasy":"✅","fern":"❌"},{"language":"Swift","speakeasy":"✅","fern":"❌"},{"language":"Unity","speakeasy":"✅","fern":"❌"}],"rowKeyField":"language"}],"\n",["$","h3",null,{"id":"sdk-features","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["SDK features",["$","$L26",null,{"id":"sdk-features"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Fern and Speakeasy SDKs differ in two key areas of feature support:"}],"\n",["$","ol",null,{"className":"list-decimal [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":"Fern lacks native support for some of the more advanced enterprise features supported by Speakeasy. Features like pagination and OAuth are left up to the customer to implement with custom code."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Fern offers customizations to the names used in the SDK but not to the fundamental structure of the SDK. In addition to names, Speakeasy allows you to customize details like the directory structure and how parameters are passed into functions."}],"\n"]}],"\n",["$","$L28",null,{"title":"SDK Features","columns":[{"key":"feature","header":"Feature"},{"key":"speakeasy","header":"Speakeasy"},{"key":"fern","header":"Fern"}],"data":[{"feature":"Union types","speakeasy":"✅","fern":"✅"},{"feature":"Server-side events","speakeasy":"✅","fern":"✅"},{"feature":"Retries","speakeasy":"✅","fern":"✅"},{"feature":"Webhooks","speakeasy":"✅","fern":"✅"},{"feature":"Async support","speakeasy":"✅","fern":"✅"},{"feature":"Custom SDK naming","speakeasy":"✅","fern":"✅"},{"feature":"Pagination","speakeasy":"✅","fern":"✅"},{"feature":"API documentation","speakeasy":"✅","fern":"✅"},{"feature":"Streaming uploads","speakeasy":"✅","fern":"❌"},{"feature":"OAuth 2.0","speakeasy":"✅","fern":"❌"},{"feature":"React Hooks support","speakeasy":"✅","fern":"❌"},{"feature":"Caching and state management","speakeasy":"✅","fern":"❌"},{"feature":"Customized SDK structure","speakeasy":"✅","fern":"❌"}],"rowKeyField":"feature"}],"\n",["$","h3",null,{"id":"platform-features","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Platform features",["$","$L26",null,{"id":"platform-features"}]]}],"\n",["$","$L25",null,{"as":"p","children":"The primary differences between the platforms are:"}],"\n",["$","ol",null,{"className":"list-decimal [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":"Fern is solely focused on the generation of artifacts. Speakeasy has a deeper platform that supports the management of API creation through CLI validation."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Speakeasy offers a web interface for managing and monitoring the creation of your SDKs."}],"\n"]}],"\n",["$","$L28",null,{"title":"Platform Features","columns":[{"key":"feature","header":"Feature"},{"key":"speakeasy","header":"Speakeasy"},{"key":"fern","header":"Fern"}],"data":[{"feature":"GitHub CI/CD","speakeasy":"✅","fern":"⚠️"},{"feature":"CLI","speakeasy":"✅","fern":"✅"},{"feature":"Web interface","speakeasy":"✅","fern":"❌"},{"feature":"Package publishing","speakeasy":"✅","fern":"✅"},{"feature":"Product documentation","speakeasy":"✅","fern":"✅"},{"feature":"Server stubs","speakeasy":"❌","fern":"✅"},{"feature":"OpenAPI validation","speakeasy":"✅","fern":"❌"},{"feature":"OpenAPI Overlays","speakeasy":"✅","fern":"❌"},{"feature":"AI-powered spec edits","speakeasy":"✅","fern":"❌"}],"rowKeyField":"feature"}],"\n",["$","$L25",null,{"as":"p","children":"⚠️ Fern claims CI/CD support for SDKs on its paid plan, but this feature is not mentioned in the documentation."}],"\n",["$","h3",null,{"id":"dependencies-and-sbom-software-bill-of-materials","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Dependencies and SBOM (Software Bill of Materials)",["$","$L26",null,{"id":"dependencies-and-sbom-software-bill-of-materials"}]]}],"\n",["$","$L25",null,{"as":"p","children":["From day one, Speakeasy has prioritized efficiency, and we’ve kept the dependency trees for our generated SDKs as lean as possible. For example, here’s the ",["$","a",null,{"href":"https://npmgraph.js.org/?q=%40vercel%2Fsdk","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["dependency graph for the Vercel SDK",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],", an SDK generated by Speakeasy. It has zero direct dependencies, and one peer dependency (Zod)."]}],"\n",["$","$L25",null,{"as":"p","children":["$","$L29",null,{"alt":"Vercel dependency graph","placeholder":"blur","src":{"src":"/_next/static/media/vercel.2bd1187f.png","height":1218,"width":2152,"blurDataURL":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAFCAMAAABPT11nAAAABlBMVEX////6+vpeqjdNAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAEklEQVR4nGNgwAIYGbGJMjAAAABcAAM8PUkQAAAAAElFTkSuQmCC","blurWidth":8,"blurHeight":5}}]}],"\n",["$","$L25",null,{"as":"p","children":["By contrast, here’s the ",["$","a",null,{"href":"https://npmgraph.js.org/?q=elevenlabs","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["dependency graph for the ElevenLabs SDK",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],", an SDK generated by Fern. It has many dependencies, which in turn have transitive dependencies, leading to a much more bloated SDK that is harder to maintain."]}],"\n",["$","$L25",null,{"as":"p","children":["$","$L29",null,{"alt":"ElevenLabs dependency graph","placeholder":"blur","src":{"src":"/_next/static/media/elevenlabs.47803e1b.png","height":1714,"width":2932,"blurDataURL":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAFCAMAAABPT11nAAAACVBMVEX39/fw8PD////+/SdmAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAIElEQVR4nCWIAQoAQBBE8P9Hb3MnpSBKtSgEON9pwG8HA2IALIJfXxUAAAAASUVORK5CYII=","blurWidth":8,"blurHeight":5}}]}],"\n",["$","$L25",null,{"as":"p","children":"Having more dependencies isn’t only bad in terms of efficiency. Many libraries might have only a single maintainer (the ElevenLabs SDK has 36 of these). This means any of these libraries could become unmaintained without warning. Similarly, many dependencies might have unaddressed critical vulnerabilities (CVs), leaving the upstream SDK vulnerable as well."}],"\n",["$","h3",null,{"id":"enterprise-support","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Enterprise support",["$","$L26",null,{"id":"enterprise-support"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Speakeasy sets up tracking on all customer repositories and will proactively triage any issues that arise."}],"\n",["$","$L28",null,{"title":"Enterprise Support","columns":[{"key":"feature","header":"Feature"},{"key":"speakeasy","header":"Speakeasy"},{"key":"fern","header":"Fern"}],"data":[{"feature":"Concierge onboarding","speakeasy":"✅","fern":"✅"},{"feature":"Private Slack channel","speakeasy":"✅","fern":"✅"},{"feature":"Enterprise SLAs","speakeasy":"✅","fern":"✅"},{"feature":"User-issues triage","speakeasy":"✅","fern":"❌"}],"rowKeyField":"feature"}],"\n",["$","h3",null,{"id":"pricing","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Pricing",["$","$L26",null,{"id":"pricing"}]]}],"\n",["$","$L25",null,{"as":"p","children":"The biggest difference between the two pricing models is the starter plan. Speakeasy offers one free SDK with unlimited endpoints, while Fern’s starter plan is paid."}],"\n",["$","$L28",null,{"title":"Pricing","columns":[{"key":"plan","header":"Plan"},{"key":"speakeasy","header":"Speakeasy"},{"key":"fern","header":"Fern"}],"data":[{"plan":"Free","speakeasy":"1 free published SDK","fern":"❌"},{"plan":"Scale-Up","speakeasy":"$$250/mo/SDK; max 50 endpoints","fern":"$$250/mo/SDK; max 50 endpoints"},{"plan":"Business","speakeasy":"$$600/mo/SDK; max 200 endpoints","fern":"$$600/mo/SDK; max 150 endpoints"},{"plan":"Enterprise","speakeasy":"Custom","fern":"Custom"}],"rowKeyField":"plan"}],"\n",["$","h2",null,{"id":"fern-and-speakeasy-walkthrough","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Fern and Speakeasy walkthrough",["$","$L26",null,{"id":"fern-and-speakeasy-walkthrough"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Let’s walk through generating an SDK with both Fern and Speakeasy. This is well explained in the documentation, so we’ll keep it brief."}],"\n",["$","$L25",null,{"as":"p","children":"Both services support Linux, macOS, and Windows, and run in Docker."}],"\n",["$","$L25",null,{"as":"p","children":["Some of the examples below are from the ",["$","a",null,{"href":"https://github.com/speakeasy-sdks/template-speakeasy-bar/","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["Speakeasy Bar Starter SDK",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],"."]}],"\n",["$","h2",null,{"id":"creating-sdks","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Creating SDKs",["$","$L26",null,{"id":"creating-sdks"}]]}],"\n",["$","h3",null,{"id":"fern-quickstart","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Fern quickstart",["$","$L26",null,{"id":"fern-quickstart"}]]}],"\n",["$","$L25",null,{"as":"p","children":["Follow the ",["$","a",null,{"href":"https://buildwithfern.com/learn/sdks/getting-started/generate-your-first-sdk","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["Fern quickstart",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],"."]}],"\n",["$","$L25",null,{"as":"p","children":["In the folder containing the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"openapi.yaml"}]," file, open a terminal and use Node.js with npm:"]}],"\n",["$","$L2a",null,{"codeblock":{"value":"npm install -g fern-api\nfern init --openapi ./openapi.yaml;\n# will require GitHub login in browser\nfern generate","lang":"shellscript","meta":"","code":"npm install -g fern-api\nfern init --openapi ./openapi.yaml;\n# will require GitHub login in browser\nfern generate","tokens":[["npm","#A6E22E"]," ",["install","#E6DB74"]," ",["-g","#AE81FF"]," ",["fern-api","#E6DB74"],"\n",["fern","#A6E22E"]," ",["init","#E6DB74"]," ",["--openapi","#AE81FF"]," ",["./openapi.yaml","#E6DB74"],[";","#F8F8F2"],"\n",["# will require GitHub login in browser","#88846F"],"\n",["fern","#A6E22E"]," ",["generate","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","code",null,{"className":"nextra-code","dir":"ltr","children":"init"}]," creates a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"fern"}]," folder containing a copy of the OpenAPI document and some configuration files."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","code",null,{"className":"nextra-code","dir":"ltr","children":"generate"}]," creates SDKs in the folder ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"../generated"}],". You can change the output folder by editing ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"generators.yaml"}],". We used the following file to create all four languages:"]}],"\n"]}],"\n",["$","$L2a",null,{"codeblock":{"value":"default-group: local\ngroups:\nlocal:\n generators:\n - name: fernapi/fern-typescript-node-sdk\n version: 0.7.2\n output:\n location: local-file-system\n path: ./generated/typescript\n config:\n outputSourceFiles: true # output .ts instead of .js with definitions files\n - name: fernapi/fern-python-sdk\n version: 0.7.2\n output:\n location: local-file-system\n path: ./generated/python\n - name: fernapi/fern-java-sdk\n version: 0.5.15\n output:\n location: local-file-system\n path: ../generated/java\n - name: fernapi/fern-go-sdk\n version: 0.9.2\n output:\n location: local-file-system\n path: ../generated/go\n - name: fernapi/fern-postman\n version: 0.0.45\n output:\n location: local-file-system\n path: ./generated/postman","lang":"yaml","meta":"","code":"default-group: local\ngroups:\nlocal:\n generators:\n - name: fernapi/fern-typescript-node-sdk\n version: 0.7.2\n output:\n location: local-file-system\n path: ./generated/typescript\n config:\n outputSourceFiles: true # output .ts instead of .js with definitions files\n - name: fernapi/fern-python-sdk\n version: 0.7.2\n output:\n location: local-file-system\n path: ./generated/python\n - name: fernapi/fern-java-sdk\n version: 0.5.15\n output:\n location: local-file-system\n path: ../generated/java\n - name: fernapi/fern-go-sdk\n version: 0.9.2\n output:\n location: local-file-system\n path: ../generated/go\n - name: fernapi/fern-postman\n version: 0.0.45\n output:\n location: local-file-system\n path: ./generated/postman","tokens":[["default-group","#F92672"],[":","#F8F8F2"]," ",["local","#E6DB74"],"\n",["groups","#F92672"],[":","#F8F8F2"],"\n",["local","#F92672"],[":","#F8F8F2"],"\n ",["generators","#F92672"],[":","#F8F8F2"],"\n ",["-","#F8F8F2"]," ",["name","#F92672"],[":","#F8F8F2"]," ",["fernapi/fern-typescript-node-sdk","#E6DB74"],"\n ",["version","#F92672"],[":","#F8F8F2"]," ",["0.7.2","#AE81FF"],"\n ",["output","#F92672"],[":","#F8F8F2"],"\n ",["location","#F92672"],[":","#F8F8F2"]," ",["local-file-system","#E6DB74"],"\n ",["path","#F92672"],[":","#F8F8F2"]," ",["./generated/typescript","#E6DB74"],"\n ",["config","#F92672"],[":","#F8F8F2"],"\n ",["outputSourceFiles","#F92672"],[":","#F8F8F2"]," ",["true","#AE81FF"]," ",["# output .ts instead of .js with definitions files","#88846F"],"\n ",["-","#F8F8F2"]," ",["name","#F92672"],[":","#F8F8F2"]," ",["fernapi/fern-python-sdk","#E6DB74"],"\n ",["version","#F92672"],[":","#F8F8F2"]," ",["0.7.2","#AE81FF"],"\n ",["output","#F92672"],[":","#F8F8F2"],"\n ",["location","#F92672"],[":","#F8F8F2"]," ",["local-file-system","#E6DB74"],"\n ",["path","#F92672"],[":","#F8F8F2"]," ",["./generated/python","#E6DB74"],"\n ",["-","#F8F8F2"]," ",["name","#F92672"],[":","#F8F8F2"]," ",["fernapi/fern-java-sdk","#E6DB74"],"\n ",["version","#F92672"],[":","#F8F8F2"]," ",["0.5.15","#AE81FF"],"\n ",["output","#F92672"],[":","#F8F8F2"],"\n ",["location","#F92672"],[":","#F8F8F2"]," ",["local-file-system","#E6DB74"],"\n ",["path","#F92672"],[":","#F8F8F2"]," ",["../generated/java","#E6DB74"],"\n ",["-","#F8F8F2"]," ",["name","#F92672"],[":","#F8F8F2"]," ",["fernapi/fern-go-sdk","#E6DB74"],"\n ",["version","#F92672"],[":","#F8F8F2"]," ",["0.9.2","#AE81FF"],"\n ",["output","#F92672"],[":","#F8F8F2"],"\n ",["location","#F92672"],[":","#F8F8F2"]," ",["local-file-system","#E6DB74"],"\n ",["path","#F92672"],[":","#F8F8F2"]," ",["../generated/go","#E6DB74"],"\n ",["-","#F8F8F2"]," ",["name","#F92672"],[":","#F8F8F2"]," ",["fernapi/fern-postman","#E6DB74"],"\n ",["version","#F92672"],[":","#F8F8F2"]," ",["0.0.45","#AE81FF"],"\n ",["output","#F92672"],[":","#F8F8F2"],"\n ",["location","#F92672"],[":","#F8F8F2"]," ",["local-file-system","#E6DB74"],"\n ",["path","#F92672"],[":","#F8F8F2"]," ",["./generated/postman","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"Fern can also generate documentation:"}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","code",null,{"className":"nextra-code","dir":"ltr","children":"init --docs"}]," creates a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"docs.yml"}]," configuration file."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","code",null,{"className":"nextra-code","dir":"ltr","children":"generate --docs;"}]," creates documentation at the URL specified in the configuration file."]}],"\n"]}],"\n",["$","h3",null,{"id":"speakeasy-quickstart","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Speakeasy quickstart",["$","$L26",null,{"id":"speakeasy-quickstart"}]]}],"\n",["$","$L25",null,{"as":"p","children":["Follow the ",["$","a",null,{"href":"https://speakeasy.com/docs/speakeasy-cli/getting-started","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["Speakeasy quickstart",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],"."]}],"\n",["$","$L25",null,{"as":"p","children":["The Speakeasy CLI is a single executable file ",["$","a",null,{"href":"https://github.com/speakeasy-api/speakeasy","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["built with Go",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],"."]}],"\n",["$","$L2a",null,{"codeblock":{"value":"brew install speakeasy-api/homebrew-tap/speakeasy\n\nspeakeasy quickstart","lang":"shellscript","meta":"","code":"brew install speakeasy-api/homebrew-tap/speakeasy\n\nspeakeasy quickstart","tokens":[["brew","#A6E22E"]," ",["install speakeasy-api/homebrew-tap/speakeasy","#E6DB74"],"\n\n",["speakeasy","#A6E22E"]," ",["quickstart","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":"Speakeasy handles authentication with a secret key in an environment variable. You can get the secret key on the Speakeasy website."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Running the Speakeasy quickstart launches an interactive mode that will guide you through generating an SDK."}],"\n"]}],"\n",["$","h2",null,{"id":"comparing-typescript-sdk-generation-with-fern-and-speakeasy","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Comparing TypeScript SDK generation with Fern and Speakeasy",["$","$L26",null,{"id":"comparing-typescript-sdk-generation-with-fern-and-speakeasy"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Comparing the output of Fern and Speakeasy for all four SDK languages Fern supports would be too long for this article. We’ll focus on TypeScript (JavaScript)."}],"\n",["$","h3",null,{"id":"sdk-structure","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["SDK structure",["$","$L26",null,{"id":"sdk-structure"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Below is the Fern folder structure."}],"\n",["$","$L2a",null,{"codeblock":{"value":"$2b","lang":"shellscript","meta":"","code":"$2c","tokens":[["├──","#A6E22E"]," ",["Client.d.ts","#E6DB74"],"\n",["├──","#A6E22E"]," ",["Client.js","#E6DB74"],"\n",["├──","#A6E22E"]," ",["api","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── errors","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── BadRequestError.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── BadRequestError.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── UnauthorizedError.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── UnauthorizedError.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── resources","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── authentication","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── client","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── Client.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── Client.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ └── requests","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── LoginRequest.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── LoginRequest.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── types","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── LoginRequestType.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── LoginRequestType.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── LoginResponse.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── LoginResponse.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── config","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── client","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── Client.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── Client.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── types","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── SubscribeToWebhooksRequestItem.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── SubscribeToWebhooksRequestItem.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── drinks","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── client","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── Client.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── Client.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ └── requests","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── ListDrinksRequest.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── ListDrinksRequest.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── ingredients","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── client","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── Client.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── Client.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ └── requests","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── ListIngredientsRequest.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── ListIngredientsRequest.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── orders","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── client","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── Client.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── Client.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── requests","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── CreateOrderRequest.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── CreateOrderRequest.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── types","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── ApiError.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── ApiError.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── BadRequest.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── BadRequest.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── Drink.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── Drink.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── DrinkType.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── DrinkType.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── Error_.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── Error_.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── Ingredient.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── Ingredient.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── IngredientType.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── IngredientType.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── Order.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── Order.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── OrderStatus.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── OrderStatus.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── OrderType.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── OrderType.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── index.js","#E6DB74"],"\n",["├──","#A6E22E"]," ",["core","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── fetcher","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── APIResponse.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── APIResponse.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── Fetcher.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── Fetcher.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── Supplier.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── Supplier.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── createRequestUrl.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── createRequestUrl.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── getFetchFn.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── getFetchFn.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── getHeader.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── getHeader.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── getRequestBody.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── getRequestBody.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── getResponseBody.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── getResponseBody.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── makeRequest.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── makeRequest.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── requestWithRetries.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── requestWithRetries.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── signals.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── signals.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── stream-wrappers","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── Node18UniversalStreamWrapper.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── Node18UniversalStreamWrapper.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── NodePre18StreamWrapper.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── NodePre18StreamWrapper.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── UndiciStreamWrapper.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── UndiciStreamWrapper.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── chooseStreamWrapper.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── chooseStreamWrapper.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── runtime","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── runtime.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── runtime.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── schemas","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── Schema.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── Schema.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── builders","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── date","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── date.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── date.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── enum","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── enum.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── enum.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── lazy","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── lazy.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── lazy.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── lazyObject.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── lazyObject.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── list","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── list.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── list.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── literals","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── booleanLiteral.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── booleanLiteral.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── stringLiteral.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── stringLiteral.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── object","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── object.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── object.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── objectWithoutOptionalProperties.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── objectWithoutOptionalProperties.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── property.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── property.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── types.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── types.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── object-like","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── getObjectLikeUtils.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── getObjectLikeUtils.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── types.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── types.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── primitives","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── any.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── any.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── boolean.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── boolean.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── number.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── number.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── string.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── string.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── unknown.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── unknown.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── record","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── record.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── record.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── types.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── types.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── schema-utils","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── JsonError.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── JsonError.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── ParseError.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── ParseError.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── getSchemaUtils.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── getSchemaUtils.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── stringifyValidationErrors.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── stringifyValidationErrors.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── set","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── set.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── set.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── undiscriminated-union","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── types.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── types.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── undiscriminatedUnion.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── undiscriminatedUnion.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── union","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── discriminant.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── discriminant.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── types.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── types.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── union.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── union.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── index.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── utils","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── MaybePromise.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── MaybePromise.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── addQuestionMarksToNullableProperties.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── addQuestionMarksToNullableProperties.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── createIdentitySchemaCreator.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── createIdentitySchemaCreator.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── entries.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── entries.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── filterObject.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── filterObject.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── getErrorMessageForIncorrectType.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── getErrorMessageForIncorrectType.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── isPlainObject.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── isPlainObject.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── keys.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── keys.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── maybeSkipValidation.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── maybeSkipValidation.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── partition.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── partition.js","#E6DB74"],"\n",["├──","#A6E22E"]," ",["environments.d.ts","#E6DB74"],"\n",["├──","#A6E22E"]," ",["environments.js","#E6DB74"],"\n",["├──","#A6E22E"]," ",["errors","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── NdimaresApiError.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── NdimaresApiError.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── NdimaresApiTimeoutError.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── NdimaresApiTimeoutError.js","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── index.d.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── index.js","#E6DB74"],"\n",["├──","#A6E22E"]," ",["index.d.ts","#E6DB74"],"\n",["├──","#A6E22E"]," ",["index.js","#E6DB74"],"\n",["└──","#A6E22E"]," ",["serialization","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["index.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["index.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["resources","#E6DB74"],"\n ",["│","#A6E22E"]," ",["├── authentication","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── client","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ └── requests","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── LoginRequest.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── LoginRequest.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ └── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ └── types","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── LoginRequestType.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── LoginRequestType.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── LoginResponse.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── LoginResponse.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ └── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["├── config","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── client","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── subscribeToWebhooks.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ └── subscribeToWebhooks.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ └── types","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── SubscribeToWebhooksRequestItem.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── SubscribeToWebhooksRequestItem.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ └── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["├── drinks","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── client","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── listDrinks.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ └── listDrinks.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ └── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["├── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["├── ingredients","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── client","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ ├── listIngredients.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ │ └── listIngredients.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ └── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["└── orders","#E6DB74"],"\n ",["│","#A6E22E"]," ",["├── client","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── createOrder.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── createOrder.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ ├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["│ └── index.js","#E6DB74"],"\n ",["│","#A6E22E"]," ",["├── index.d.ts","#E6DB74"],"\n ",["│","#A6E22E"]," ",["└── index.js","#E6DB74"],"\n ",["└──","#A6E22E"]," ",["types","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["ApiError.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["ApiError.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["BadRequest.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["BadRequest.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["Drink.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["Drink.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["DrinkType.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["DrinkType.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["Error_.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["Error_.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["Ingredient.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["Ingredient.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["IngredientType.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["IngredientType.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["Order.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["Order.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["OrderStatus.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["OrderStatus.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["OrderType.d.ts","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["OrderType.js","#E6DB74"],"\n ",["├──","#A6E22E"]," ",["index.d.ts","#E6DB74"],"\n ",["└──","#A6E22E"]," ",["index.js","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"Below is the Speakeasy folder structure."}],"\n",["$","$L2a",null,{"codeblock":{"value":"$2d","lang":"shellscript","meta":"","code":"$2e","tokens":[["├──","#A6E22E"]," ",["CONTRIBUTING.md","#E6DB74"],"\n",["├──","#A6E22E"]," ",["FUNCTIONS.md","#E6DB74"],"\n",["├──","#A6E22E"]," ",["README.md","#E6DB74"],"\n",["├──","#A6E22E"]," ",["RUNTIMES.md","#E6DB74"],"\n",["├──","#A6E22E"]," ",["USAGE.md","#E6DB74"],"\n",["├──","#A6E22E"]," ",["docs","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── lib","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── utils","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── retryconfig.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── models","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── callbacks","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── createorderorderupdaterequestbody.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── components","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── drink.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── drinktype.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── errort.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── ingredient.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── ingredienttype.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── order.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── ordertype.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── security.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── status.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── errors","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── apierror.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── badrequest.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── operations","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── createorderrequest.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── createorderresponse.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── getdrinkrequest.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── getdrinkresponse.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── listdrinksrequest.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── listdrinksresponse.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── listdrinkssecurity.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── listingredientsrequest.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── listingredientsresponse.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── loginrequestbody.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── loginresponse.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── loginresponsebody.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── loginsecurity.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── requestbody.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── type.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── webhook.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── webhooks","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── stockupdaterequestbody.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── sdks","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── authentication","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── README.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── config","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── README.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── drinks","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── README.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── ingredients","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── README.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── orders","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── README.md","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── sdk","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── README.md","#E6DB74"],"\n",["├──","#A6E22E"]," ",["jsr.json","#E6DB74"],"\n",["├──","#A6E22E"]," ",["package.json","#E6DB74"],"\n",["├──","#A6E22E"]," ",["src","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── core.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── funcs","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── authenticationLogin.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── configSubscribeToWebhooks.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── drinksGetDrink.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── drinksListDrinks.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── ingredientsListIngredients.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── ordersCreateOrder.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── hooks","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── hooks.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── registration.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── types.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── index.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── lib","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── base64.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── config.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── dlv.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── encodings.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── files.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── http.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── is-plain-object.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── logger.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── matchers.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── primitives.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── retries.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── schemas.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── sdks.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── security.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── url.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── models","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── callbacks","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── createorder.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── index.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── components","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── drink.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── drinkinput.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── drinktype.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── error.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── ingredient.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── ingredientinput.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── ingredienttype.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── order.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── orderinput.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── ordertype.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── security.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── errors","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── apierror.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── badrequest.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── httpclienterrors.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── sdkerror.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── sdkvalidationerror.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── operations","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── createorder.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── getdrink.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── index.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── listdrinks.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── listingredients.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ ├── login.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ │ └── subscribetowebhooks.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── webhooks","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── stockupdate.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── sdk","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── authentication.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── config.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── drinks.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── index.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── ingredients.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ ├── orders.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["│ └── sdk.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── types","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── blobs.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── constdatetime.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── enums.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── fp.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── index.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── operations.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["├── rfcdate.ts","#E6DB74"],"\n",["│","#A6E22E"]," ",["└── streams.ts","#E6DB74"],"\n",["└──","#A6E22E"]," ",["tsconfig.json","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"Speakeasy includes a documentation folder next to the SDK folder."}],"\n",["$","$L25",null,{"as":"p","children":["Speakeasy creates a complete npm package, with a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"package.json"}]," file, that is ready to be published to the npm registry. With Fern, you have to do extra work to prepare for publishing."]}],"\n",["$","$L25",null,{"as":"p","children":["The structure of the SDK also has some bearing on the DevEx. To call order functions in the SDKs, you would use ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"api/resources/orders/Client.js"}]," in Fern and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"src/sdk/orders.ts"}]," in Speakeasy."]}],"\n",["$","h3",null,{"id":"example-sdk-method","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Example SDK method",["$","$L26",null,{"id":"example-sdk-method"}]]}],"\n",["$","$L25",null,{"as":"p","children":["Let’s take a look at the code for a single call, ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"createOrder"}],", in Fern and Speakeasy."]}],"\n",["$","div",null,{"className":"md:flex gap-10","children":[["$","div",null,{"className":"md:w-1/2","children":["$","$L2a",null,{"codeblock":{"value":"$2f","lang":"typescript","meta":"fern-example/createOrder.ts","code":"$30","tokens":["\n",["/","#F92672"],["\\","#F8F8F2"],["*","#F92672"],["\\","#F8F8F2"],["*","#F92672"],"\n\n",["-","#F92672"]," ",["Create an order for a drink.","#F8F8F2"],"\n ",["_","#F8F8F2"],["/","#F92672"],"\n ",["createOrder","#A6E22E"],["(request, requestOptions) {","#F8F8F2"],"\n ",["var","#66D9EF",{"fontStyle":"italic"}]," ",["\\_a;","#F8F8F2"],"\n ",["return","#F92672"]," ",["\\_\\","#F8F8F2"],["_awaiter","#A6E22E"],["(","#F8F8F2"],["this","#FD971F"],[",","#F8F8F2"]," ",["void","#F92672"]," ",["0","#AE81FF"],[",","#F8F8F2"]," ",["void","#F92672"]," ",["0","#AE81FF"],[",","#F8F8F2"]," ",["function_","#A6E22E"]," ",["() {","#F8F8F2"],"\n ",["const { callbackUrl, body: \\_body } = request;","#F8F8F2"],"\n ",["const \\_queryParams","#F8F8F2"]," ",["= new","#F92672"]," ",["url_search_params_1.","#F8F8F2"],["default","#A6E22E"],["();","#F8F8F2"],"\n ",["if","#A6E22E"]," ",["(","#F8F8F2"],["callbackUrl","#FD971F",{"fontStyle":"italic"}]," ",["!=","#F8F8F2"]," ",["null","#FD971F",{"fontStyle":"italic"}],[") {","#F8F8F2"],"\n ",["\\_queryParams.","#F8F8F2"],["append","#A6E22E"],["(","#F8F8F2"],["\"callback_url\"","#E6DB74"],[", callbackUrl);","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["const \\_response","#F8F8F2"]," ",["= yield","#F92672"]," ",["core.","#F8F8F2"],["fetcher","#A6E22E"],["({","#F8F8F2"],"\n ",["url: (","#F8F8F2"],["0","#AE81FF"],[", url_join_1.default)((\\_a","#F8F8F2"]," ",["=","#F92672"]," ",["(","#F8F8F2"],["yield","#F92672"]," ",["core.Supplier.","#F8F8F2"],["get","#A6E22E"],["(","#F8F8F2"],["this","#FD971F"],[".\\_options.environment)))","#F8F8F2"]," ",["!==","#F92672"]," ",["null","#AE81FF"]," ",["&&","#F92672"]," ",["\\_a","#F8F8F2"]," ",["!== void","#F92672"]," ",["0","#AE81FF"]," ",["?","#F92672"]," ",["\\_a","#F8F8F2"]," ",[":","#F92672"]," ",["environments.NdimaresApiEnvironment.Default,","#F8F8F2"]," ",["\"order\"","#E6DB74"],["),","#F8F8F2"],"\n ",["method:","#F8F8F2"]," ",["\"POST\"","#E6DB74"],[",","#F8F8F2"],"\n ",["headers: {","#F8F8F2"],"\n ",["Authorization:","#F8F8F2"]," ",["yield","#F92672"]," ",["this","#FD971F"],[".\\","#F8F8F2"],["_getAuthorizationHeader","#A6E22E"],["(),","#F8F8F2"],"\n ",["\"X-Fern-Language\"","#E6DB74"],[":","#F8F8F2"]," ",["\"JavaScript\"","#E6DB74"],[",","#F8F8F2"],"\n ",["},","#F8F8F2"],"\n ",["contentType:","#F8F8F2"]," ",["\"application/json\"","#E6DB74"],[",","#F8F8F2"],"\n ",["queryParameters: \\_queryParams,","#F8F8F2"],"\n ",["body:","#F8F8F2"]," ",["yield","#F92672"]," ",["serializers.orders.createOrder.Request.","#F8F8F2"],["jsonOrThrow","#A6E22E"],["(\\_body, { unrecognizedObjectKeys:","#F8F8F2"]," ",["\"strip\"","#E6DB74"]," ",["}),","#F8F8F2"],"\n ",["timeoutMs: (requestOptions","#F8F8F2"]," ",["===","#F92672"]," ",["null","#AE81FF"]," ",["||","#F92672"]," ",["requestOptions","#F8F8F2"]," ",["=== void","#F92672"]," ",["0","#AE81FF"]," ",["? void","#F92672"]," ",["0","#AE81FF"]," ",[":","#F92672"]," ",["requestOptions.timeoutInSeconds)","#F8F8F2"]," ",["!=","#F92672"]," ",["null","#AE81FF"]," ",["?","#F92672"]," ",["requestOptions.timeoutInSeconds \\","#F8F8F2"],["*","#F92672"]," ",["1000","#AE81FF"]," ",[":","#F92672"]," ",["60000","#AE81FF"],[",","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n ",["if","#A6E22E"]," ",["(\\_response.ok) {","#F8F8F2"],"\n ",["return yield","#F92672"]," ",["serializers.Order.","#F8F8F2"],["parseOrThrow","#A6E22E"],["(\\_response.body, {","#F8F8F2"],"\n ",["unrecognizedObjectKeys:","#F8F8F2"]," ",["\"passthrough\"","#E6DB74"],[",","#F8F8F2"],"\n ",["allowUnrecognizedUnionMembers:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["allowUnrecognizedEnumValues:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["breadcrumbsPrefix: [","#F8F8F2"],["\"response\"","#E6DB74"],["],","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["if","#A6E22E"]," ",["(\\_response.error.reason ===","#F8F8F2"]," ",["\"status-code\"","#E6DB74"],[") {","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["errors.","#F8F8F2"],["NdimaresApiError","#A6E22E"],["({","#F8F8F2"],"\n ",["statusCode: \\_response.error.statusCode,","#F8F8F2"],"\n ",["body: \\_response.error.body,","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["switch","#A6E22E"]," ",["(\\_response.error.reason) {","#F8F8F2"],"\n ",["case","#F92672"]," ",["\"non-json\"","#E6DB74"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["errors.","#F8F8F2"],["NdimaresApiError","#A6E22E"],["({","#F8F8F2"],"\n ",["statusCode: \\_response.error.statusCode,","#F8F8F2"],"\n ",["body: \\_response.error.rawBody,","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n ",["case","#F92672"]," ",["\"timeout\"","#E6DB74"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["errors.","#F8F8F2"],["NdimaresApiTimeoutError","#A6E22E"],["();","#F8F8F2"],"\n ",["case","#F92672"]," ",["\"unknown\"","#E6DB74"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["errors.","#F8F8F2"],["NdimaresApiError","#A6E22E"],["({","#F8F8F2"],"\n ",["message: \\_response.error.errorMessage,","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n"],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}]}],["$","div",null,{"className":"md:w-1/2","children":["$","$L2a",null,{"codeblock":{"value":"$31","lang":"typescript","meta":"speakeasy-example/createOrder.ts","code":"$32","tokens":[["/**","#88846F"],"\n ",["* Create an order.","#88846F"],"\n ",["*","#88846F"],"\n ",["*","#88846F"]," ",["@remarks","#66D9EF",{"fontStyle":"italic"}],"\n ",["* Create an order for a drink.","#88846F"],"\n ",["*/","#88846F"],"\n",["export async","#F92672"]," ",["function","#66D9EF",{"fontStyle":"italic"}]," ",["ordersCreateOrder","#A6E22E"],["(","#F8F8F2"],"\n ",["client$","#FD971F",{"fontStyle":"italic"}],[":","#F92672"]," ",["SDKCore","#A6E22E",{"textDecoration":"underline"}],[",","#F8F8F2"],"\n ",["request","#FD971F",{"fontStyle":"italic"}],[":","#F92672"]," ",["operations","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["CreateOrderRequest","#A6E22E",{"textDecoration":"underline"}],[",","#F8F8F2"],"\n ",["options","#FD971F",{"fontStyle":"italic"}],["?:","#F92672"]," ",["RequestOptions","#A6E22E",{"textDecoration":"underline"}],"\n",[")","#F8F8F2"],[":","#F92672"]," ",["Promise","#A6E22E",{"textDecoration":"underline"}],["<","#F8F8F2"],"\n ",["Result","#A6E22E",{"textDecoration":"underline"}],["<","#F8F8F2"],"\n ",["operations","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["CreateOrderResponse","#A6E22E",{"textDecoration":"underline"}],[",","#F8F8F2"],"\n ",["|","#F92672"]," ",["errors","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["APIError","#A6E22E",{"textDecoration":"underline"}],"\n ",["|","#F92672"]," ",["SDKError","#A6E22E",{"textDecoration":"underline"}],"\n ",["|","#F92672"]," ",["SDKValidationError","#A6E22E",{"textDecoration":"underline"}],"\n ",["|","#F92672"]," ",["UnexpectedClientError","#A6E22E",{"textDecoration":"underline"}],"\n ",["|","#F92672"]," ",["InvalidRequestError","#A6E22E",{"textDecoration":"underline"}],"\n ",["|","#F92672"]," ",["RequestAbortedError","#A6E22E",{"textDecoration":"underline"}],"\n ",["|","#F92672"]," ",["RequestTimeoutError","#A6E22E",{"textDecoration":"underline"}],"\n ",["|","#F92672"]," ",["ConnectionError","#A6E22E",{"textDecoration":"underline"}],"\n ",[">","#F8F8F2"],"\n",["> {","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["input$","#F8F8F2"]," ",["=","#F92672"]," ",["request;","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["parsed$","#F8F8F2"]," ",["=","#F92672"]," ",["schemas$.","#F8F8F2"],["safeParse","#A6E22E"],["(","#F8F8F2"],"\n ",["input$,","#F8F8F2"],"\n ",["(","#F8F8F2"],["value$","#FD971F",{"fontStyle":"italic"}],[")","#F8F8F2"]," ",["=>","#66D9EF",{"fontStyle":"italic"}]," ",["operations.CreateOrderRequest$outboundSchema.","#F8F8F2"],["parse","#A6E22E"],["(value$),","#F8F8F2"],"\n ",["\"Input validation failed\"","#E6DB74"],"\n ",[");","#F8F8F2"],"\n ",["if","#F92672"]," ",["(","#F8F8F2"],["!","#F92672"],["parsed$.ok) {","#F8F8F2"],"\n ",["return","#F92672"]," ",["parsed$;","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["payload$","#F8F8F2"]," ",["=","#F92672"]," ",["parsed$.value;","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["body$","#F8F8F2"]," ",["=","#F92672"]," ",["encodeJSON$","#A6E22E"],["(","#F8F8F2"],["\"body\"","#E6DB74"],[", payload$.RequestBody, { explode:","#F8F8F2"]," ",["true","#AE81FF"]," ",["});","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["path$","#F8F8F2"]," ",["=","#F92672"]," ",["pathToFunc","#A6E22E"],["(","#F8F8F2"],["\"/order\"","#E6DB74"],[")();","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["query$","#F8F8F2"]," ",["=","#F92672"]," ",["encodeFormQuery$","#A6E22E"],["({","#F8F8F2"],"\n ",["callback_url: payload$.callback_url,","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["headers$","#F8F8F2"]," ",["= new","#F92672"]," ",["Headers","#A6E22E"],["({","#F8F8F2"],"\n ",["\"Content-Type\"","#E6DB74"],[":","#F8F8F2"]," ",["\"application/json\"","#E6DB74"],[",","#F8F8F2"],"\n ",["Accept:","#F8F8F2"]," ",["\"application/json\"","#E6DB74"],[",","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["security$","#F8F8F2"]," ",["= await","#F92672"]," ",["extractSecurity","#A6E22E"],["(client$.options$.security);","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["context","#F8F8F2"]," ",["=","#F92672"]," ",["{","#F8F8F2"],"\n ",["operationID:","#F8F8F2"]," ",["\"createOrder\"","#E6DB74"],[",","#F8F8F2"],"\n ",["oAuth2Scopes: [],","#F8F8F2"],"\n ",["securitySource: client$.options$.security,","#F8F8F2"],"\n ",["};","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["securitySettings$","#F8F8F2"]," ",["=","#F92672"]," ",["resolveGlobalSecurity","#A6E22E"],["(security$);","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["requestRes","#F8F8F2"]," ",["=","#F92672"]," ",["client$.","#F8F8F2"],["createRequest$","#A6E22E"],["(","#F8F8F2"],"\n ",["context,","#F8F8F2"],"\n ",["{","#F8F8F2"],"\n ",["security: securitySettings$,","#F8F8F2"],"\n ",["method:","#F8F8F2"]," ",["\"POST\"","#E6DB74"],[",","#F8F8F2"],"\n ",["path: path$,","#F8F8F2"],"\n ",["headers: headers$,","#F8F8F2"],"\n ",["query: query$,","#F8F8F2"],"\n ",["body: body$,","#F8F8F2"],"\n ",["timeoutMs: options?.timeoutMs","#F8F8F2"]," ",["||","#F92672"]," ",["client$.options$.timeoutMs","#F8F8F2"]," ",["|| -","#F92672"],["1","#AE81FF"],[",","#F8F8F2"],"\n ",["},","#F8F8F2"],"\n ",["options","#F8F8F2"],"\n ",[");","#F8F8F2"],"\n ",["if","#F92672"]," ",["(","#F8F8F2"],["!","#F92672"],["requestRes.ok) {","#F8F8F2"],"\n ",["return","#F92672"]," ",["requestRes;","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["request$","#F8F8F2"]," ",["=","#F92672"]," ",["requestRes.value;","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["doResult","#F8F8F2"]," ",["= await","#F92672"]," ",["client$.","#F8F8F2"],["do$","#A6E22E"],["(request$, {","#F8F8F2"],"\n ",["context,","#F8F8F2"],"\n ",["errorCodes: [","#F8F8F2"],["\"4XX\"","#E6DB74"],[",","#F8F8F2"]," ",["\"5XX\"","#E6DB74"],["],","#F8F8F2"],"\n ",["retryConfig: options?.retries","#F8F8F2"]," ",["||","#F92672"]," ",["client$.options$.retryConfig,","#F8F8F2"],"\n ",["retryCodes: options?.retryCodes","#F8F8F2"]," ",["||","#F92672"]," ",["[","#F8F8F2"],["\"429\"","#E6DB74"],[",","#F8F8F2"]," ",["\"500\"","#E6DB74"],[",","#F8F8F2"]," ",["\"502\"","#E6DB74"],[",","#F8F8F2"]," ",["\"503\"","#E6DB74"],[",","#F8F8F2"]," ",["\"504\"","#E6DB74"],["],","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n ",["if","#F92672"]," ",["(","#F8F8F2"],["!","#F92672"],["doResult.ok) {","#F8F8F2"],"\n ",["return","#F92672"]," ",["doResult;","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["response","#F8F8F2"]," ",["=","#F92672"]," ",["doResult.value;","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["responseFields$","#F8F8F2"]," ",["=","#F92672"]," ",["{","#F8F8F2"],"\n ",["HttpMeta: { Response: response, Request: request$ },","#F8F8F2"],"\n ",["};","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["[result$]","#F8F8F2"]," ",["= await","#F92672"]," ",["m$.match","#F8F8F2"],["<","#F92672"],"\n ",["operations.CreateOrderResponse,","#F8F8F2"],"\n ",["|","#F92672"]," ",["errors.APIError","#F8F8F2"],"\n ",["|","#F92672"]," ",["SDKError","#F8F8F2"],"\n ",["|","#F92672"]," ",["SDKValidationError","#F8F8F2"],"\n ",["|","#F92672"]," ",["UnexpectedClientError","#F8F8F2"],"\n ",["|","#F92672"]," ",["InvalidRequestError","#F8F8F2"],"\n ",["|","#F92672"]," ",["RequestAbortedError","#F8F8F2"],"\n ",["|","#F92672"]," ",["RequestTimeoutError","#F8F8F2"],"\n ",["|","#F92672"]," ",["ConnectionError","#F8F8F2"],"\n ",[">","#F92672"],["(","#F8F8F2"],"\n ",["m$.","#F8F8F2"],["json","#A6E22E"],["(","#F8F8F2"],["200","#AE81FF"],[", operations.CreateOrderResponse$inboundSchema),","#F8F8F2"],"\n ",["m$.","#F8F8F2"],["fail","#A6E22E"],["(","#F8F8F2"],["\"4XX\"","#E6DB74"],["),","#F8F8F2"],"\n ",["m$.","#F8F8F2"],["jsonErr","#A6E22E"],["(","#F8F8F2"],["\"5XX\"","#E6DB74"],[", errors.APIError$inboundSchema),","#F8F8F2"],"\n ",["m$.","#F8F8F2"],["json","#A6E22E"],["(","#F8F8F2"],["\"default\"","#E6DB74"],[", operations.CreateOrderResponse$inboundSchema)","#F8F8F2"],"\n ",[")(response, { extraFields: responseFields$ });","#F8F8F2"],"\n ",["if","#F92672"]," ",["(","#F8F8F2"],["!","#F92672"],["result$.ok) {","#F8F8F2"],"\n ",["return","#F92672"]," ",["result$;","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["return","#F92672"]," ",["result$;","#F8F8F2"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}]}]]}],"\n",["$","h3",null,{"id":"type-safety","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Type safety",["$","$L26",null,{"id":"type-safety"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Both Fern and Speakeasy ensure that, if the input is incorrect, the SDK will throw an error instead of silently giving you incorrect data."}],"\n",["$","$L25",null,{"as":"p","children":["Fern uses a custom data serialization validator to validate every object received by your SDK from the server. See an example of this in ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"api/resources/pet/client/Client.ts"}],", where the line ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"return await serializers.Pet.parseOrThrow(_response.body, {"}]," calls into the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"core/schemas/builders"}]," code."]}],"\n",["$","$L25",null,{"as":"p","children":["Speakeasy uses ",["$","a",null,{"href":"https://github.com/colinhacks/zod","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["Zod",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],", an open-source validator, eliminating the need for custom serialization code."]}],"\n",["$","h3",null,{"id":"file-streaming","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["File streaming",["$","$L26",null,{"id":"file-streaming"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Streaming file transmission allows servers and clients to do gradual processing, which is useful for playing videos or transforming long text files."}],"\n",["$","$L25",null,{"as":"p","children":["Fern ",["$","a",null,{"href":"https://buildwithfern.com/learn/api-definition/openapi/endpoints/sse","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["supports file streaming",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," but with the use of a proprietary endpoint extension, ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"x-fern-streaming: true"}],"."]}],"\n",["$","$L25",null,{"as":"p","children":["Speakeasy supports the ",["$","a",null,{"href":"https://developer.mozilla.org/en-US/docs/Web/API/Streams_API","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["Streams API",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," web standard automatically. You can use code like the following to upload and download large files:"]}],"\n",["$","$L2a",null,{"codeblock":{"value":"const fileHandle = await openAsBlob(\"./src/sample.txt\");\nconst result = await sdk.upload({ file: fileHandle });","lang":"javascript","meta":"","code":"const fileHandle = await openAsBlob(\"./src/sample.txt\");\nconst result = await sdk.upload({ file: fileHandle });","tokens":[["const","#66D9EF",{"fontStyle":"italic"}]," ",["fileHandle","#F8F8F2"]," ",["= await","#F92672"]," ",["openAsBlob","#A6E22E"],["(","#F8F8F2"],["\"./src/sample.txt\"","#E6DB74"],[");","#F8F8F2"],"\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["result","#F8F8F2"]," ",["= await","#F92672"]," ",["sdk.","#F8F8F2"],["upload","#A6E22E"],["({ file: fileHandle });","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","h3",null,{"id":"react-hooks","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["React Hooks",["$","$L26",null,{"id":"react-hooks"}]]}],"\n",["$","$L25",null,{"as":"p","children":"React Hooks simplify state and data management in React apps, enabling developers to consume APIs more efficiently."}],"\n",["$","$L25",null,{"as":"p","children":"Fern does not support React Hooks natively. Developers must manually integrate SDK methods into state management tools like React Context, Redux, or TanStack Query."}],"\n",["$","$L25",null,{"as":"p","children":["Speakeasy generates built-in React Hooks using ",["$","a",null,{"href":"https://tanstack.com/query/latest","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["TanStack Query",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],". These hooks provide features like intelligent caching, type safety, pagination, and seamless integration with modern React patterns such as SSR and Suspense."]}],"\n",["$","$L25",null,{"as":"p","children":"Here’s an example:"}],"\n",["$","$L2a",null,{"codeblock":{"value":"import { useQuery } from \"@tanstack/react-query\";\n\nfunction Posts() {\n const { data, status, error } = useQuery([\n \"posts\" // Cache key for the query\n ], async () => {\n const response = await fetch(\"https://jsonplaceholder.typicode.com/posts\");\n return response.json();\n });\n\n if (status === \"loading\") return

Loading posts...

;\n if (status === \"error\") return

Error: {error?.message}

;\n\n return (\n

{post.title}

\n );\n}","lang":"typescript","meta":"example/loadPosts.tsx","code":"import { useQuery } from \"@tanstack/react-query\";\n\nfunction Posts() {\n const { data, status, error } = useQuery([\n \"posts\" // Cache key for the query\n ], async () => {\n const response = await fetch(\"https://jsonplaceholder.typicode.com/posts\");\n return response.json();\n });\n\n if (status === \"loading\") return

Loading posts...

;\n if (status === \"error\") return

Error: {error?.message}

;\n\n return (\n

{post.title}

\n );\n}","tokens":[["import","#F92672"]," ",["{ useQuery }","#F8F8F2"]," ",["from","#F92672"]," ",["\"@tanstack/react-query\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["function","#66D9EF",{"fontStyle":"italic"}]," ",["Posts","#A6E22E"],["() {","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["{ data, status, error }","#F8F8F2"]," ",["=","#F92672"]," ",["useQuery","#A6E22E"],["([","#F8F8F2"],"\n ",["\"posts\"","#E6DB74"]," ",["// Cache key for the query","#88846F"],"\n ",["],","#F8F8F2"]," ",["async","#F92672"]," ",["()","#F8F8F2"]," ",["=>","#66D9EF",{"fontStyle":"italic"}]," ",["{","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["response","#F8F8F2"]," ",["= await","#F92672"]," ",["fetch","#A6E22E"],["(","#F8F8F2"],["\"https://jsonplaceholder.typicode.com/posts\"","#E6DB74"],[");","#F8F8F2"],"\n ",["return","#F92672"]," ",["response.","#F8F8F2"],["json","#A6E22E"],["();","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n\n ",["if","#F92672"]," ",["(status","#F8F8F2"]," ",["===","#F92672"]," ",["\"loading\"","#E6DB74"],[")","#F8F8F2"]," ",["return","#F92672"]," ",["<","#F8F8F2"],["p","#A6E22E",{"textDecoration":"underline"}],[">Loading posts","#F8F8F2"],["...","#F92672"],[";","#F8F8F2"],"\n ",["if","#F92672"]," ",["(status","#F8F8F2"]," ",["===","#F92672"]," ",["\"error\"","#E6DB74"],[")","#F8F8F2"]," ",["return","#F92672"]," ",["<","#F8F8F2"],["p","#A6E22E",{"textDecoration":"underline"}],[">Error: {error?.message}","#F8F8F2"],["","#F92672"],[";","#F8F8F2"],"\n\n ",["return","#F92672"]," ",["(","#F8F8F2"],"\n ",["<","#F8F8F2"],["ul","#A6E22E",{"textDecoration":"underline"}],[">","#F8F8F2"],"\n ",["{","#F8F8F2"],["data","#FD971F",{"fontStyle":"italic"}],[".","#F8F8F2"],["map","#FD971F",{"fontStyle":"italic"}],["((","#F8F8F2"],["post","#FD971F",{"fontStyle":"italic"}],[")","#F8F8F2"]," ",["=>","#F92672"]," ",["(","#F8F8F2"],"\n ",["<","#F92672"],["li key","#F8F8F2"],["=","#F92672"],["{post.id}","#F8F8F2"],[">","#F92672"],["{post.title}","#F8F8F2"],["","#F92672"],"\n ",["))}","#F8F8F2"],"\n ",["","#F92672"],"\n ",[");","#F8F8F2"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["In this example, the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"useQuery"}]," hook fetches data from an API endpoint. The cache key ensures unique identification of the query. The ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"status"}]," variable provides the current state of the query: ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"loading"}],", ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"error"}],", or ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"success"}],". Depending on the query status, the component renders ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"loading"}],", ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"error"}],", or the fetched data as a list."]}],"\n",["$","h4",null,{"id":"auto-pagination","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-xl","children":["Auto-pagination",["$","$L26",null,{"id":"auto-pagination"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Speakeasy’s React Hooks also enable auto-pagination, which automatically fetches more data when the user scrolls to the bottom of the page. This feature is useful for infinite scrolling in social media feeds or search results."}],"\n",["$","$L2a",null,{"codeblock":{"value":"import { useInView } from \"react-intersection-observer\";\n\nimport { useActorAuthorFeedInfinite } from \"@speakeasy-api/bluesky/react-query/actorAuthorFeed.js\";\n\nexport function PostsView(props: { did: string }) {\n const { data, fetchNextPage, hasNextPage } = useActorAuthorFeedInfinite({\n actor: props.did,\n });\n\n const { ref } = useInView({\n rootMargin: \"50px\",\n onChange(inView) {\n if (inView) { fetchNextPage(); }\n },\n });\n\n return (\n

\n \n

\n {hasNextPage ?

: null}\n

\n );","lang":"typescript","meta":"example/PostsView.tsx","code":"import { useInView } from \"react-intersection-observer\";\n\nimport { useActorAuthorFeedInfinite } from \"@speakeasy-api/bluesky/react-query/actorAuthorFeed.js\";\n\nexport function PostsView(props: { did: string }) {\n const { data, fetchNextPage, hasNextPage } = useActorAuthorFeedInfinite({\n actor: props.did,\n });\n\n const { ref } = useInView({\n rootMargin: \"50px\",\n onChange(inView) {\n if (inView) { fetchNextPage(); }\n },\n });\n\n return (\n

\n \n

\n {hasNextPage ?

: null}\n

\n );","tokens":[["import","#F92672"]," ",["{ useInView }","#F8F8F2"]," ",["from","#F92672"]," ",["\"react-intersection-observer\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["import","#F92672"]," ",["{ useActorAuthorFeedInfinite }","#F8F8F2"]," ",["from","#F92672"]," ",["\"@speakeasy-api/bluesky/react-query/actorAuthorFeed.js\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["export","#F92672"]," ",["function","#66D9EF",{"fontStyle":"italic"}]," ",["PostsView","#A6E22E"],["(","#F8F8F2"],["props","#FD971F",{"fontStyle":"italic"}],[":","#F92672"]," ",["{ did","#F8F8F2"],[":","#F92672"]," ",["string","#66D9EF",{"fontStyle":"italic"}]," ",["}) {","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["{ data, fetchNextPage, hasNextPage }","#F8F8F2"]," ",["=","#F92672"]," ",["useActorAuthorFeedInfinite","#A6E22E"],["({","#F8F8F2"],"\n ",["actor: props.did,","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["{ ref }","#F8F8F2"]," ",["=","#F92672"]," ",["useInView","#A6E22E"],["({","#F8F8F2"],"\n ",["rootMargin:","#F8F8F2"]," ",["\"50px\"","#E6DB74"],[",","#F8F8F2"],"\n ",["onChange","#A6E22E"],["(","#F8F8F2"],["inView","#FD971F",{"fontStyle":"italic"}],[") {","#F8F8F2"],"\n ",["if","#F92672"]," ",["(inView) {","#F8F8F2"]," ",["fetchNextPage","#A6E22E"],["(); }","#F8F8F2"],"\n ",["},","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n\n ",["return","#F92672"]," ",["(","#F8F8F2"],"\n ",["<","#F8F8F2"],["div","#A6E22E",{"textDecoration":"underline"}],[">","#F8F8F2"],"\n ",["<","#F92672"],["ul className","#F8F8F2"],["=","#F92672"],["\"space-y-4\"","#E6DB74"],[">","#F92672"],"\n ",["{","#F8F8F2"],["data","#FD971F",{"fontStyle":"italic"}],["?.","#F8F8F2"],["pages","#FD971F",{"fontStyle":"italic"}],[".","#F8F8F2"],["flatMap","#FD971F",{"fontStyle":"italic"}],["((","#F8F8F2"],["page","#FD971F",{"fontStyle":"italic"}],[")","#F8F8F2"]," ",["=>","#F92672"]," ",["{","#F8F8F2"],"\n ",["return page.result.feed.map((entry) => (","#F8F8F2"],"\n ",["

","#F92672"],"\n ",["","#F92672"],"\n ",["

","#F8F8F2"],"\n ",["));","#F8F8F2"],"\n ",["})}","#F8F8F2"],"\n ",["","#F92672"],"\n ",["{","#F8F8F2"],["hasNextPage","#FD971F",{"fontStyle":"italic"}]," ",["? <","#F8F8F2"],["div ref","#FD971F",{"fontStyle":"italic"}],["=","#F92672"],["{ref}","#F8F8F2"]," ",["/>","#F92672"]," ",[":","#F8F8F2"]," ",["null","#AE81FF"],["}","#F8F8F2"],"\n ",["","#F92672"],"\n ",[");","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"Fern also supports pagination, but only offset- and cursor-based pagination, and these require additional configuration."}],"\n",["$","$L25",null,{"as":"p","children":["For an in-depth look at how Speakeasy uses React Hooks, see our ",["$","a",null,{"href":"https://www.speakeasy.com/post/release-react-hooks","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["official release article",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],"."]}],"\n",["$","h3",null,{"id":"webhooks-support","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Webhooks support",["$","$L26",null,{"id":"webhooks-support"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Webhooks enable users to receive real-time updates from your API through HTTP callbacks in your SDK. Both Speakeasy and Fern generate SDKs that support webhooks and provide built-in support for webhook validation, payload parsing, and delivery."}],"\n",["$","$L25",null,{"as":"p","children":"However, the way the platforms handle webhooks differs slightly. Speakeasy provides a higher-level abstraction that includes validation and event type inference, whereas Fern requires manual event handling after signature verification."}],"\n",["$","$L25",null,{"as":"p","children":"We’ll use an example bookstore API to demonstrate how both SDKs handle webhooks."}],"\n",["$","$L25",null,{"as":"p","children":"First we’ll look at the OpenAPI definition for the webhook:"}],"\n",["$","$L2a",null,{"codeblock":{"value":"openapi: 3.1.1\npaths: ...\nx-speakeasy-webhooks:\n security:\n type: signature # a preset which signs the request body with HMAC\n name: x-signature # the name of the header\n encoding: base64 # encoding of the signature in the header\n algorithm: hmac-sha256\nwebhooks:\n book.created:\n post:\n requestBody:\n required: true\n content:\n application/json:\n schema:\n type: object\n properties:\n id:\n type: string\n title:\n type: string\n required:\n - id\n - title\n responses:\n \"200\":\n description: Book creation event received\n book.deleted: ...","lang":"yaml","meta":"","code":"openapi: 3.1.1\npaths: ...\nx-speakeasy-webhooks:\n security:\n type: signature # a preset which signs the request body with HMAC\n name: x-signature # the name of the header\n encoding: base64 # encoding of the signature in the header\n algorithm: hmac-sha256\nwebhooks:\n book.created:\n post:\n requestBody:\n required: true\n content:\n application/json:\n schema:\n type: object\n properties:\n id:\n type: string\n title:\n type: string\n required:\n - id\n - title\n responses:\n \"200\":\n description: Book creation event received\n book.deleted: ...","tokens":[["openapi","#F92672"],[":","#F8F8F2"]," ",["3.1.1","#AE81FF"],"\n",["paths","#F92672"],[":","#F8F8F2"]," ",["...","#AE81FF"],"\n",["x-speakeasy-webhooks","#F92672"],[":","#F8F8F2"],"\n ",["security","#F92672"],[":","#F8F8F2"],"\n ",["type","#F92672"],[":","#F8F8F2"]," ",["signature","#E6DB74"]," ",["# a preset which signs the request body with HMAC","#88846F"],"\n ",["name","#F92672"],[":","#F8F8F2"]," ",["x-signature","#E6DB74"]," ",["# the name of the header","#88846F"],"\n ",["encoding","#F92672"],[":","#F8F8F2"]," ",["base64","#E6DB74"]," ",["# encoding of the signature in the header","#88846F"],"\n ",["algorithm","#F92672"],[":","#F8F8F2"]," ",["hmac-sha256","#E6DB74"],"\n",["webhooks","#F92672"],[":","#F8F8F2"],"\n ",["book.created","#F92672"],[":","#F8F8F2"],"\n ",["post","#F92672"],[":","#F8F8F2"],"\n ",["requestBody","#F92672"],[":","#F8F8F2"],"\n ",["required","#F92672"],[":","#F8F8F2"]," ",["true","#AE81FF"],"\n ",["content","#F92672"],[":","#F8F8F2"],"\n ",["application/json","#F92672"],[":","#F8F8F2"],"\n ",["schema","#F92672"],[":","#F8F8F2"],"\n ",["type","#F92672"],[":","#F8F8F2"]," ",["object","#E6DB74"],"\n ",["properties","#F92672"],[":","#F8F8F2"],"\n ",["id","#F92672"],[":","#F8F8F2"],"\n ",["type","#F92672"],[":","#F8F8F2"]," ",["string","#E6DB74"],"\n ",["title","#F92672"],[":","#F8F8F2"],"\n ",["type","#F92672"],[":","#F8F8F2"]," ",["string","#E6DB74"],"\n ",["required","#F92672"],[":","#F8F8F2"],"\n ",["-","#F8F8F2"]," ",["id","#E6DB74"],"\n ",["-","#F8F8F2"]," ",["title","#E6DB74"],"\n ",["responses","#F92672"],[":","#F8F8F2"],"\n ",["\"200\"","#E6DB74"],[":","#F8F8F2"],"\n ",["description","#F92672"],[":","#F8F8F2"]," ",["Book creation event received","#E6DB74"],"\n ",["book.deleted","#F92672"],[":","#F8F8F2"]," ",["...","#AE81FF"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"Here’s how you would handle the webhook using the SDKs:"}],"\n",["$","div",null,{"className":"md:flex gap-10","children":[["$","div",null,{"className":"md:w-1/2","children":["$","$L2a",null,{"codeblock":{"value":"// techbooks-speakeasy SDK created by Speakeasy\nimport { TechBooks } from \"techbooks-speakeasy\";\n\nconst bookStore = new TechBooks();\n\nasync function handleWebhook(request: Request) {\n const secret = \"my-webhook-secret\";\n\n const res = await bookStore.webhooks.validateWebhook({ request, secret });\n\n if (res.error) {\n console.error(\"Webhook validation failed:\", res.error);\n throw new Error(\"Invalid webhook signature\");\n }\n\n // Speakeasy provides type inference and payload parsing\n const { data, inferredType } = res;\n\n switch (data.type) {\n case \"book.created\":\n console.log(\"New Book Created:\", data.title);\n break;\n case \"book.deleted\":\n console.log(\"Book Deleted:\", data.title);\n break;\n default:\n console.warn(`Unhandled event type: ${inferredType}`);\n }\n}","lang":"typescript","meta":"speakeasy-example/webhook.ts","code":"// techbooks-speakeasy SDK created by Speakeasy\nimport { TechBooks } from \"techbooks-speakeasy\";\n\nconst bookStore = new TechBooks();\n\nasync function handleWebhook(request: Request) {\n const secret = \"my-webhook-secret\";\n\n const res = await bookStore.webhooks.validateWebhook({ request, secret });\n\n if (res.error) {\n console.error(\"Webhook validation failed:\", res.error);\n throw new Error(\"Invalid webhook signature\");\n }\n\n // Speakeasy provides type inference and payload parsing\n const { data, inferredType } = res;\n\n switch (data.type) {\n case \"book.created\":\n console.log(\"New Book Created:\", data.title);\n break;\n case \"book.deleted\":\n console.log(\"Book Deleted:\", data.title);\n break;\n default:\n console.warn(`Unhandled event type: ${inferredType}`);\n }\n}","tokens":[["// techbooks-speakeasy SDK created by Speakeasy","#88846F"],"\n",["import","#F92672"]," ",["{ TechBooks }","#F8F8F2"]," ",["from","#F92672"]," ",["\"techbooks-speakeasy\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["bookStore","#F8F8F2"]," ",["= new","#F92672"]," ",["TechBooks","#A6E22E"],["();","#F8F8F2"],"\n\n",["async","#F92672"]," ",["function","#66D9EF",{"fontStyle":"italic"}]," ",["handleWebhook","#A6E22E"],["(","#F8F8F2"],["request","#FD971F",{"fontStyle":"italic"}],[":","#F92672"]," ",["Request","#A6E22E",{"textDecoration":"underline"}],[") {","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["secret","#F8F8F2"]," ",["=","#F92672"]," ",["\"my-webhook-secret\"","#E6DB74"],[";","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["res","#F8F8F2"]," ",["= await","#F92672"]," ",["bookStore.webhooks.","#F8F8F2"],["validateWebhook","#A6E22E"],["({ request, secret });","#F8F8F2"],"\n\n ",["if","#F92672"]," ",["(res.error) {","#F8F8F2"],"\n ",["console.","#F8F8F2"],["error","#A6E22E"],["(","#F8F8F2"],["\"Webhook validation failed:\"","#E6DB74"],[", res.error);","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Error","#A6E22E"],["(","#F8F8F2"],["\"Invalid webhook signature\"","#E6DB74"],[");","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["// Speakeasy provides type inference and payload parsing","#88846F"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["{ data, inferredType }","#F8F8F2"]," ",["=","#F92672"]," ",["res;","#F8F8F2"],"\n\n ",["switch","#F92672"]," ",["(data.type) {","#F8F8F2"],"\n ",["case","#F92672"]," ",["\"book.created\"","#E6DB74"],[":","#F8F8F2"],"\n ",["console.","#F8F8F2"],["log","#A6E22E"],["(","#F8F8F2"],["\"New Book Created:\"","#E6DB74"],[", data.title);","#F8F8F2"],"\n ",["break","#F92672"],[";","#F8F8F2"],"\n ",["case","#F92672"]," ",["\"book.deleted\"","#E6DB74"],[":","#F8F8F2"],"\n ",["console.","#F8F8F2"],["log","#A6E22E"],["(","#F8F8F2"],["\"Book Deleted:\"","#E6DB74"],[", data.title);","#F8F8F2"],"\n ",["break","#F92672"],[";","#F8F8F2"],"\n ",["default","#F92672"],[":","#F8F8F2"],"\n ",["console.","#F8F8F2"],["warn","#A6E22E"],["(","#F8F8F2"],["`Unhandled event type:","#E6DB74"]," ",["$${","#F92672"],["inferredType","#F8F8F2"],["}","#F92672"],["`","#E6DB74"],[");","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}]}],["$","div",null,{"className":"md:w-1/2","children":["$","$L2a",null,{"codeblock":{"value":"// techbooks-fern SDK created by Fern\nimport FernClient from 'fern-sdk';\n\nconst client = new FernClient();\n\nasync function handleWebhook(req) {\n try {\n const payload = client.webhooks.constructEvent({\n body: req.body,\n signature: req.headers['x-imdb-signature'],\n secret: process.env.WEBHOOK_SECRET\n });\n\n if (payload.type === \"book.created\") {\n console.log(\"New Book Created:\", payload.title);\n } else if (payload.type === \"book.deleted\") {\n console.log(\"Book Deleted:\", payload.title);\n } else {\n console.warn(`Unhandled event type: ${payload.type}`);\n }\n } catch (error) {\n console.error(\"Webhook validation failed:\", error);\n throw new Error(\"Invalid webhook signature\");\n }\n}","lang":"typescript","meta":"fern-example/webhook.ts","code":"// techbooks-fern SDK created by Fern\nimport FernClient from 'fern-sdk';\n\nconst client = new FernClient();\n\nasync function handleWebhook(req) {\n try {\n const payload = client.webhooks.constructEvent({\n body: req.body,\n signature: req.headers['x-imdb-signature'],\n secret: process.env.WEBHOOK_SECRET\n });\n\n if (payload.type === \"book.created\") {\n console.log(\"New Book Created:\", payload.title);\n } else if (payload.type === \"book.deleted\") {\n console.log(\"Book Deleted:\", payload.title);\n } else {\n console.warn(`Unhandled event type: ${payload.type}`);\n }\n } catch (error) {\n console.error(\"Webhook validation failed:\", error);\n throw new Error(\"Invalid webhook signature\");\n }\n}","tokens":[["// techbooks-fern SDK created by Fern","#88846F"],"\n",["import","#F92672"]," ",["FernClient","#F8F8F2"]," ",["from","#F92672"]," ",["'fern-sdk'","#E6DB74"],[";","#F8F8F2"],"\n\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["client","#F8F8F2"]," ",["= new","#F92672"]," ",["FernClient","#A6E22E"],["();","#F8F8F2"],"\n\n",["async","#F92672"]," ",["function","#66D9EF",{"fontStyle":"italic"}]," ",["handleWebhook","#A6E22E"],["(","#F8F8F2"],["req","#FD971F",{"fontStyle":"italic"}],[") {","#F8F8F2"],"\n ",["try","#F92672"]," ",["{","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["payload","#F8F8F2"]," ",["=","#F92672"]," ",["client.webhooks.","#F8F8F2"],["constructEvent","#A6E22E"],["({","#F8F8F2"],"\n ",["body: req.body,","#F8F8F2"],"\n ",["signature: req.headers[","#F8F8F2"],["'x-imdb-signature'","#E6DB74"],["],","#F8F8F2"],"\n ",["secret: process.env.WEBHOOK_SECRET","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n\n ",["if","#F92672"]," ",["(payload.type","#F8F8F2"]," ",["===","#F92672"]," ",["\"book.created\"","#E6DB74"],[") {","#F8F8F2"],"\n ",["console.","#F8F8F2"],["log","#A6E22E"],["(","#F8F8F2"],["\"New Book Created:\"","#E6DB74"],[", payload.title);","#F8F8F2"],"\n ",["}","#F8F8F2"]," ",["else if","#F92672"]," ",["(payload.type","#F8F8F2"]," ",["===","#F92672"]," ",["\"book.deleted\"","#E6DB74"],[") {","#F8F8F2"],"\n ",["console.","#F8F8F2"],["log","#A6E22E"],["(","#F8F8F2"],["\"Book Deleted:\"","#E6DB74"],[", payload.title);","#F8F8F2"],"\n ",["}","#F8F8F2"]," ",["else","#F92672"]," ",["{","#F8F8F2"],"\n ",["console.","#F8F8F2"],["warn","#A6E22E"],["(","#F8F8F2"],["`Unhandled event type:","#E6DB74"]," ",["$${","#F92672"],["payload.type","#F8F8F2"],["}","#F92672"],["`","#E6DB74"],[");","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n ",["}","#F8F8F2"]," ",["catch","#F92672"]," ",["(error) {","#F8F8F2"],"\n ",["console.","#F8F8F2"],["error","#A6E22E"],["(","#F8F8F2"],["\"Webhook validation failed:\"","#E6DB74"],[", error);","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Error","#A6E22E"],["(","#F8F8F2"],["\"Invalid webhook signature\"","#E6DB74"],[");","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}]}]]}],"\n",["$","$L25",null,{"as":"p","children":["You can read more about how Speakeasy handles webhooks in our ",["$","$L27",null,{"href":"/post/release-webhooks-support","prefetch":"$undefined","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":"webhooks release post"}],"."]}],"\n",["$","h3",null,{"id":"oauth-client-credentials-handling","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["OAuth client credentials handling",["$","$L26",null,{"id":"oauth-client-credentials-handling"}]]}],"\n",["$","div",null,{"className":"callout contrast-more:border-current! my-6 flex gap-x-2 rounded-lg border py-2 pe-4 border-blue-100 bg-blue-50 [&_.text-body]:text-blue-800 text-blue-800 dark:border-blue-200/30 dark:bg-blue-900/30 dark:text-blue-200 dark:[&_.text-body]:text-blue-200 [&_a]:text-blue-600 dark:[&_a]:text-blue-200 [&_a:hover]:text-blue-600 dark:[&_a:hover]:text-blue-100","children":[["$","div",null,{"className":"ps-3 pe-2 text-xl select-none","data-pagefind-ignore":"all","style":{"fontFamily":"\"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\""},"children":"ℹ️"}],["$","div",null,{"className":"w-full min-w-0 leading-7","children":[["$","strong",null,{"children":"NOTE"}],["$","$L25",null,{"as":"p","children":"OAuth 2.0 client handling is only available on Fern’s paid plans. Speakeasy\nsupports OAuth 2.0 client credentials on all plans."}]]}]]}],"\n",["$","$L25",null,{"as":"p","children":"Both Speakeasy and Fern generate SDKs that handle OAuth 2.0 with client credentials, offering similar functionality in managing the token lifecycle and authentication processes."}],"\n",["$","$L25",null,{"as":"p","children":"Our bookstore API requires an OAuth 2.0 token with client credentials to access the API. Let’s see how the SDKs handle this."}],"\n",["$","$L25",null,{"as":"p","children":"Consider the following OAuth 2.0 configuration from the OpenAPI document:"}],"\n",["$","$L2a",null,{"codeblock":{"value":"components:\n securitySchemes:\n OAuth2:\n type: oauth2\n flows:\n clientCredentials:\n tokenUrl: https://api.bookstore.com/oauth/token\n scopes:\n write: Grants write access\n read: Grants read access","lang":"yaml","meta":"","code":"components:\n securitySchemes:\n OAuth2:\n type: oauth2\n flows:\n clientCredentials:\n tokenUrl: https://api.bookstore.com/oauth/token\n scopes:\n write: Grants write access\n read: Grants read access","tokens":[["components","#F92672"],[":","#F8F8F2"],"\n ",["securitySchemes","#F92672"],[":","#F8F8F2"],"\n ",["OAuth2","#F92672"],[":","#F8F8F2"],"\n ",["type","#F92672"],[":","#F8F8F2"]," ",["oauth2","#E6DB74"],"\n ",["flows","#F92672"],[":","#F8F8F2"],"\n ",["clientCredentials","#F92672"],[":","#F8F8F2"],"\n ",["tokenUrl","#F92672"],[":","#F8F8F2"]," ",["https://api.bookstore.com/oauth/token","#E6DB74"],"\n ",["scopes","#F92672"],[":","#F8F8F2"],"\n ",["write","#F92672"],[":","#F8F8F2"]," ",["Grants write access","#E6DB74"],"\n ",["read","#F92672"],[":","#F8F8F2"]," ",["Grants read access","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"Let’s look at how you can use the SDKs to create a new book in the bookstore API and how to handle OAuth 2.0 authentication."}],"\n",["$","div",null,{"className":"md:flex gap-10","children":[["$","div",null,{"className":"md:w-1/2","children":["$","$L2a",null,{"codeblock":{"value":"import { TechBooks } from \"techbooks-speakeasy\";\n\nconst bookStore = new TechBooks({\n security: {\n // OAuth 2.0 client credentials\n clientID: \"\",\n clientSecret: \"\",\n },\n});\n\nasync function run() {\n // The SDK handles the token lifecycle, retries, and error handling for you\n await bookStore.books.addBook({\n // Book object\n });\n}\n\nrun();","lang":"typescript","meta":"example/techbooks-speakeasy.ts","code":"import { TechBooks } from \"techbooks-speakeasy\";\n\nconst bookStore = new TechBooks({\n security: {\n // OAuth 2.0 client credentials\n clientID: \"\",\n clientSecret: \"\",\n },\n});\n\nasync function run() {\n // The SDK handles the token lifecycle, retries, and error handling for you\n await bookStore.books.addBook({\n // Book object\n });\n}\n\nrun();","tokens":[["import","#F92672"]," ",["{ TechBooks }","#F8F8F2"]," ",["from","#F92672"]," ",["\"techbooks-speakeasy\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["bookStore","#F8F8F2"]," ",["= new","#F92672"]," ",["TechBooks","#A6E22E"],["({","#F8F8F2"],"\n ",["security: {","#F8F8F2"],"\n ",["// OAuth 2.0 client credentials","#88846F"],"\n ",["clientID:","#F8F8F2"]," ",["\"\"","#E6DB74"],[",","#F8F8F2"],"\n ",["clientSecret:","#F8F8F2"]," ",["\"\"","#E6DB74"],[",","#F8F8F2"],"\n ",["},","#F8F8F2"],"\n",["});","#F8F8F2"],"\n\n",["async","#F92672"]," ",["function","#66D9EF",{"fontStyle":"italic"}]," ",["run","#A6E22E"],["() {","#F8F8F2"],"\n ",["// The SDK handles the token lifecycle, retries, and error handling for you","#88846F"],"\n ",["await","#F92672"]," ",["bookStore.books.","#F8F8F2"],["addBook","#A6E22E"],["({","#F8F8F2"],"\n ",["// Book object","#88846F"],"\n ",["});","#F8F8F2"],"\n",["}","#F8F8F2"],"\n\n",["run","#A6E22E"],["();","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}]}],["$","div",null,{"className":"md:w-1/2","children":["$","$L2a",null,{"codeblock":{"value":"import FernClient from 'fern-sdk';\n\nconst client = new FernClient({\n clientId: '',\n clientSecret: '',\n});\n\nasync function run() {\n await client.books.addBook({\n // Book object\n });\n}\n\nrun();","lang":"typescript","meta":"example/techbooks-fern.ts","code":"import FernClient from 'fern-sdk';\n\nconst client = new FernClient({\n clientId: '',\n clientSecret: '',\n});\n\nasync function run() {\n await client.books.addBook({\n // Book object\n });\n}\n\nrun();","tokens":[["import","#F92672"]," ",["FernClient","#F8F8F2"]," ",["from","#F92672"]," ",["'fern-sdk'","#E6DB74"],[";","#F8F8F2"],"\n\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["client","#F8F8F2"]," ",["= new","#F92672"]," ",["FernClient","#A6E22E"],["({","#F8F8F2"],"\n ",["clientId:","#F8F8F2"]," ",["''","#E6DB74"],[",","#F8F8F2"],"\n ",["clientSecret:","#F8F8F2"]," ",["''","#E6DB74"],[",","#F8F8F2"],"\n",["});","#F8F8F2"],"\n\n",["async","#F92672"]," ",["function","#66D9EF",{"fontStyle":"italic"}]," ",["run","#A6E22E"],["() {","#F8F8F2"],"\n ",["await","#F92672"]," ",["client.books.","#F8F8F2"],["addBook","#A6E22E"],["({","#F8F8F2"],"\n ",["// Book object","#88846F"],"\n ",["});","#F8F8F2"],"\n",["}","#F8F8F2"],"\n\n",["run","#A6E22E"],["();","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}]}]]}],"\n",["$","$L25",null,{"as":"p","children":"Both Speakeasy and Fern SDKs handle OAuth 2.0 automatically – you provide credentials when creating the client, and the SDK manages token lifecycle, refreshes, and errors for you without additional manual handling."}],"\n",["$","h2",null,{"id":"fern-generated-sdk-case-study-cohere-typescript","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Fern-generated SDK case study: Cohere TypeScript",["$","$L26",null,{"id":"fern-generated-sdk-case-study-cohere-typescript"}]]}],"\n",["$","$L25",null,{"as":"p","children":["Let’s take a closer look at a real-world SDK generated by Fern for a more complete view of Fern’s SDK generation. We inspected the ",["$","a",null,{"href":"https://github.com/cohere-ai/cohere-typescript","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["Cohere TypeScript SDK",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," and here’s what we found."]}],"\n",["$","h3",null,{"id":"sdk-structure-1","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["SDK structure",["$","$L26",null,{"id":"sdk-structure-1"}]]}],"\n",["$","$L25",null,{"as":"p","children":"The Cohere SDK’s repository is deeply nested, reminiscent of older Java codebases. This may reflect the generator’s codebase, or it may be due to the generator’s templates being designed by developers who aren’t TypeScript specialists."}],"\n",["$","$L25",null,{"as":"p","children":"There is a separation between core SDK code and API-specific code such as models and request methods, but internal SDK tools that hide behind layers of abstraction are not marked clearly as internal. This can lead to breaking changes in users’ applications in the future."}],"\n",["$","$L25",null,{"as":"p","children":"Speakeasy addresses these problems by clearly separating core internal code into separate files, or marking individual code blocks as clearly as possible for internal use. Repository structure and comments follow the best practices for each SDK’s target platform, as designed by specialists in each platform."}],"\n",["$","h3",null,{"id":"data-validation-libraries","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Data validation libraries",["$","$L26",null,{"id":"data-validation-libraries"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Both Speakeasy and Fern generate SDKs that feature runtime data validation. We’ve observed that Speakeasy uses Zod, a popular and thoroughly tested data validation and schema declaration library."}],"\n",["$","$L25",null,{"as":"p","children":"The Cohere TypeScript SDK, on the other hand, uses a custom Zod-like type-checking library, which ships as part of the SDK. Using a hand-rolled type library is a questionable practice for various reasons."}],"\n",["$","$L25",null,{"as":"p","children":"Firstly, it ships type inference code as part of the SDK, which adds significant complexity."}],"\n",["$","$L25",null,{"as":"p","children":["Here’s an example of ",["$","a",null,{"href":"https://github.com/cohere-ai/cohere-typescript/blob/30ac11173e374e66310184834831cc5fca2256fc/src/core/schemas/builders/date/date.ts#L6-L8","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["date type inference",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," using complex regular expression copied from Stack Overflow."]}],"\n",["$","$L2a",null,{"codeblock":{"value":"// !focus(6:8)\nimport { BaseSchema, Schema, SchemaType } from \"../../Schema\";\nimport { getErrorMessageForIncorrectType } from \"../../utils/getErrorMessageForIncorrectType\";\nimport { maybeSkipValidation } from \"../../utils/maybeSkipValidation\";\nimport { getSchemaUtils } from \"../schema-utils\";\n\n// https://stackoverflow.com/questions/12756159/regex-and-iso8601-formatted-datetime\nconst ISO_8601_REGEX =\n /^([+-]?\\d{4}(?!\\d{2}\\b))((-?)((0[1-9]|1[0-2])(\\3([12]\\d|0[1-9]|3[01]))?|W([0-4]\\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\\d|[12]\\d{2}|3([0-5]\\d|6[1-6])))([T\\s]((([01]\\d|2[0-3])((:?)[0-5]\\d)?|24:?00)([.,]\\d+(?!:))?)?(\\17[0-5]\\d([.,]\\d+)?)?([zZ]|([+-])([01]\\d|2[0-3]):?([0-5]\\d)?)?)?)?$/;","lang":"typescript","meta":"src/core/schemas/builders/date/date.ts","code":"import { BaseSchema, Schema, SchemaType } from \"../../Schema\";\nimport { getErrorMessageForIncorrectType } from \"../../utils/getErrorMessageForIncorrectType\";\nimport { maybeSkipValidation } from \"../../utils/maybeSkipValidation\";\nimport { getSchemaUtils } from \"../schema-utils\";\n\n// https://stackoverflow.com/questions/12756159/regex-and-iso8601-formatted-datetime\nconst ISO_8601_REGEX =\n /^([+-]?\\d{4}(?!\\d{2}\\b))((-?)((0[1-9]|1[0-2])(\\3([12]\\d|0[1-9]|3[01]))?|W([0-4]\\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\\d|[12]\\d{2}|3([0-5]\\d|6[1-6])))([T\\s]((([01]\\d|2[0-3])((:?)[0-5]\\d)?|24:?00)([.,]\\d+(?!:))?)?(\\17[0-5]\\d([.,]\\d+)?)?([zZ]|([+-])([01]\\d|2[0-3]):?([0-5]\\d)?)?)?)?$/;","tokens":[["import","#F92672"]," ",["{ BaseSchema, Schema, SchemaType }","#F8F8F2"]," ",["from","#F92672"]," ",["\"../../Schema\"","#E6DB74"],[";","#F8F8F2"],"\n",["import","#F92672"]," ",["{ getErrorMessageForIncorrectType }","#F8F8F2"]," ",["from","#F92672"]," ",["\"../../utils/getErrorMessageForIncorrectType\"","#E6DB74"],[";","#F8F8F2"],"\n",["import","#F92672"]," ",["{ maybeSkipValidation }","#F8F8F2"]," ",["from","#F92672"]," ",["\"../../utils/maybeSkipValidation\"","#E6DB74"],[";","#F8F8F2"],"\n",["import","#F92672"]," ",["{ getSchemaUtils }","#F8F8F2"]," ",["from","#F92672"]," ",["\"../schema-utils\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["// https://stackoverflow.com/questions/12756159/regex-and-iso8601-formatted-datetime","#88846F"],"\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["ISO_8601_REGEX","#F8F8F2"]," ",["=","#F92672"],"\n ",["/","#E6DB74"],["^","#F92672"],["(","#E6DB74"],["[+-]","#AE81FF"],["?","#F92672"],["\\d","#AE81FF"],["{4}","#F92672"],["(?!","#E6DB74"],["\\d","#AE81FF"],["{2}\\b","#F92672"],["))((-","#E6DB74"],["?","#F92672"],[")((0","#E6DB74"],["[1-9]","#AE81FF"],["|","#F92672"],["1","#E6DB74"],["[0-2]","#AE81FF"],[")(","#E6DB74"],["\\3","#F92672"],["(","#E6DB74"],["[12]\\d","#AE81FF"],["|","#F92672"],["0","#E6DB74"],["[1-9]","#AE81FF"],["|","#F92672"],["3","#E6DB74"],["[01]","#AE81FF"],["))","#E6DB74"],["?|","#F92672"],["W(","#E6DB74"],["[0-4]\\d","#AE81FF"],["|","#F92672"],["5","#E6DB74"],["[0-2]","#AE81FF"],[")(-","#E6DB74"],["?","#F92672"],["[1-7]","#AE81FF"],[")","#E6DB74"],["?|","#F92672"],["(00","#E6DB74"],["[1-9]","#AE81FF"],["|","#F92672"],["0","#E6DB74"],["[1-9]\\d","#AE81FF"],["|","#F92672"],["[12]\\d","#AE81FF"],["{2}|","#F92672"],["3(","#E6DB74"],["[0-5]\\d","#AE81FF"],["|","#F92672"],["6","#E6DB74"],["[1-6]","#AE81FF"],[")))(","#E6DB74"],["[T\\s]","#AE81FF"],["(((","#E6DB74"],["[01]\\d","#AE81FF"],["|","#F92672"],["2","#E6DB74"],["[0-3]","#AE81FF"],[")((:","#E6DB74"],["?","#F92672"],[")","#E6DB74"],["[0-5]\\d","#AE81FF"],[")","#E6DB74"],["?|","#F92672"],["24:","#E6DB74"],["?","#F92672"],["00)(","#E6DB74"],["[.,]\\d","#AE81FF"],["+","#F92672"],["(?!:))","#E6DB74"],["?","#F92672"],[")","#E6DB74"],["?","#F92672"],["(","#E6DB74"],["\\17","#F92672"],["[0-5]\\d","#AE81FF"],["(","#E6DB74"],["[.,]\\d","#AE81FF"],["+","#F92672"],[")","#E6DB74"],["?","#F92672"],[")","#E6DB74"],["?","#F92672"],["(","#E6DB74"],["[zZ]","#AE81FF"],["|","#F92672"],["(","#E6DB74"],["[+-]","#AE81FF"],[")(","#E6DB74"],["[01]\\d","#AE81FF"],["|","#F92672"],["2","#E6DB74"],["[0-3]","#AE81FF"],["):","#E6DB74"],["?","#F92672"],["(","#E6DB74"],["[0-5]\\d","#AE81FF"],[")","#E6DB74"],["?","#F92672"],[")","#E6DB74"],["?","#F92672"],[")","#E6DB74"],["?","#F92672"],[")","#E6DB74"],["?$","#F92672"],["/","#E6DB74"],[";","#F8F8F2"]],"annotations":[{"name":"focus","query":"","fromLineNumber":6,"toLineNumber":8}],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["While Zod uses a similar regex-based approach to dates under the hood, we know that Zod’s types and methods are widely used, tested by thousands of brilliant teams each day, and are supported by stellar ",["$","a",null,{"href":"https://zod.dev/?id=dates","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["documentation",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],"."]}],"\n",["$","$L25",null,{"as":"p","children":"Furthermore, using Zod in SDKs created by Speakeasy allows users to include Zod as an external library when bundling their applications. This is what Speakeasy encourages, by including Zod as a peer dependency to the SDK."}],"\n",["$","$L25",null,{"as":"p","children":"A hand-rolled type library will almost certainly lead to safety issues that are challenging to debug and impossible to find answers for from other developers, as there is no community support."}],"\n",["$","h3",null,{"id":"documentation","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Documentation",["$","$L26",null,{"id":"documentation"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Apart from a short README, the Cohere TypeScript SDK does not include any documentation. This is in stark contrast to SDKs created by Speakeasy, which contain copy-paste usage examples for all methods and documentation for each model. Speakeasy SDKs are also supported by Zod’s detailed and clear documentation regarding types and validation."}],"\n",["$","h3",null,{"id":"readability","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Readability",["$","$L26",null,{"id":"readability"}]]}],"\n",["$","$L25",null,{"as":"p","children":"SDK method bodies in the Cohere SDK are extremely long, unclear, and contain repeated verbose response-matching code. As a result, methods are difficult to read and understand at a glance."}],"\n",["$","$L25",null,{"as":"p","children":"Response matching in SDK methods involves long switch statements that are repeated in each method. The snippet below from the Cohere SDK is repeated multiple times."}],"\n",["$","$L2a",null,{"codeblock":{"value":"$33","lang":"typescript","meta":"src/Client.ts","code":"$34","tokens":[["// ...","#88846F"],"\n",["if","#F92672"]," ",["(_response.error.reason","#F8F8F2"]," ",["===","#F92672"]," ",["\"status-code\"","#E6DB74"],[") {","#F8F8F2"],"\n ",["switch","#F92672"]," ",["(_response.error.statusCode) {","#F8F8F2"],"\n ",["case","#F92672"]," ",["400","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["BadRequestError","#A6E22E"],["(_response.error.body);","#F8F8F2"],"\n ",["case","#F92672"]," ",["401","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["UnauthorizedError","#A6E22E"],["(_response.error.body);","#F8F8F2"],"\n ",["case","#F92672"]," ",["403","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["ForbiddenError","#A6E22E"],["(_response.error.body);","#F8F8F2"],"\n ",["case","#F92672"]," ",["404","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["NotFoundError","#A6E22E"],["(_response.error.body);","#F8F8F2"],"\n ",["case","#F92672"]," ",["422","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["UnprocessableEntityError","#A6E22E"],["(","#F8F8F2"],"\n ",["await","#F92672"]," ",["serializers.UnprocessableEntityErrorBody.","#F8F8F2"],["parseOrThrow","#A6E22E"],["(","#F8F8F2"],"\n ",["_response.error.body,","#F8F8F2"],"\n ",["{","#F8F8F2"],"\n ",["unrecognizedObjectKeys:","#F8F8F2"]," ",["\"passthrough\"","#E6DB74"],[",","#F8F8F2"],"\n ",["allowUnrecognizedUnionMembers:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["allowUnrecognizedEnumValues:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["skipValidation:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["breadcrumbsPrefix: [","#F8F8F2"],["\"response\"","#E6DB74"],["],","#F8F8F2"],"\n ",["},","#F8F8F2"],"\n ",["),","#F8F8F2"],"\n ",[");","#F8F8F2"],"\n ",["case","#F92672"]," ",["429","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["TooManyRequestsError","#A6E22E"],["(","#F8F8F2"],"\n ",["await","#F92672"]," ",["serializers.TooManyRequestsErrorBody.","#F8F8F2"],["parseOrThrow","#A6E22E"],["(","#F8F8F2"],"\n ",["_response.error.body,","#F8F8F2"],"\n ",["{","#F8F8F2"],"\n ",["unrecognizedObjectKeys:","#F8F8F2"]," ",["\"passthrough\"","#E6DB74"],[",","#F8F8F2"],"\n ",["allowUnrecognizedUnionMembers:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["allowUnrecognizedEnumValues:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["skipValidation:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["breadcrumbsPrefix: [","#F8F8F2"],["\"response\"","#E6DB74"],["],","#F8F8F2"],"\n ",["},","#F8F8F2"],"\n ",["),","#F8F8F2"],"\n ",[");","#F8F8F2"],"\n ",["case","#F92672"]," ",["499","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["ClientClosedRequestError","#A6E22E"],["(","#F8F8F2"],"\n ",["await","#F92672"]," ",["serializers.ClientClosedRequestErrorBody.","#F8F8F2"],["parseOrThrow","#A6E22E"],["(","#F8F8F2"],"\n ",["_response.error.body,","#F8F8F2"],"\n ",["{","#F8F8F2"],"\n ",["unrecognizedObjectKeys:","#F8F8F2"]," ",["\"passthrough\"","#E6DB74"],[",","#F8F8F2"],"\n ",["allowUnrecognizedUnionMembers:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["allowUnrecognizedEnumValues:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["skipValidation:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["breadcrumbsPrefix: [","#F8F8F2"],["\"response\"","#E6DB74"],["],","#F8F8F2"],"\n ",["},","#F8F8F2"],"\n ",["),","#F8F8F2"],"\n ",[");","#F8F8F2"],"\n ",["case","#F92672"]," ",["500","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["InternalServerError","#A6E22E"],["(_response.error.body);","#F8F8F2"],"\n ",["case","#F92672"]," ",["501","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["NotImplementedError","#A6E22E"],["(","#F8F8F2"],"\n ",["await","#F92672"]," ",["serializers.NotImplementedErrorBody.","#F8F8F2"],["parseOrThrow","#A6E22E"],["(","#F8F8F2"],"\n ",["_response.error.body,","#F8F8F2"],"\n ",["{","#F8F8F2"],"\n ",["unrecognizedObjectKeys:","#F8F8F2"]," ",["\"passthrough\"","#E6DB74"],[",","#F8F8F2"],"\n ",["allowUnrecognizedUnionMembers:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["allowUnrecognizedEnumValues:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["skipValidation:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["breadcrumbsPrefix: [","#F8F8F2"],["\"response\"","#E6DB74"],["],","#F8F8F2"],"\n ",["},","#F8F8F2"],"\n ",["),","#F8F8F2"],"\n ",[");","#F8F8F2"],"\n ",["case","#F92672"]," ",["503","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["ServiceUnavailableError","#A6E22E"],["(_response.error.body);","#F8F8F2"],"\n ",["case","#F92672"]," ",["504","#AE81FF"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["Cohere.","#F8F8F2"],["GatewayTimeoutError","#A6E22E"],["(","#F8F8F2"],"\n ",["await","#F92672"]," ",["serializers.GatewayTimeoutErrorBody.","#F8F8F2"],["parseOrThrow","#A6E22E"],["(","#F8F8F2"],"\n ",["_response.error.body,","#F8F8F2"],"\n ",["{","#F8F8F2"],"\n ",["unrecognizedObjectKeys:","#F8F8F2"]," ",["\"passthrough\"","#E6DB74"],[",","#F8F8F2"],"\n ",["allowUnrecognizedUnionMembers:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["allowUnrecognizedEnumValues:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["skipValidation:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["breadcrumbsPrefix: [","#F8F8F2"],["\"response\"","#E6DB74"],["],","#F8F8F2"],"\n ",["},","#F8F8F2"],"\n ",["),","#F8F8F2"],"\n ",[");","#F8F8F2"],"\n ",["default","#F92672"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["errors.","#F8F8F2"],["CohereError","#A6E22E"],["({","#F8F8F2"],"\n ",["statusCode: _response.error.statusCode,","#F8F8F2"],"\n ",["body: _response.error.body,","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n",["}","#F8F8F2"],"\n\n",["switch","#F92672"]," ",["(_response.error.reason) {","#F8F8F2"],"\n ",["case","#F92672"]," ",["\"non-json\"","#E6DB74"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["errors.","#F8F8F2"],["CohereError","#A6E22E"],["({","#F8F8F2"],"\n ",["statusCode: _response.error.statusCode,","#F8F8F2"],"\n ",["body: _response.error.rawBody,","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n ",["case","#F92672"]," ",["\"timeout\"","#E6DB74"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["errors.","#F8F8F2"],["CohereTimeoutError","#A6E22E"],["();","#F8F8F2"],"\n ",["case","#F92672"]," ",["\"unknown\"","#E6DB74"],[":","#F8F8F2"],"\n ",["throw new","#F92672"]," ",["errors.","#F8F8F2"],["CohereError","#A6E22E"],["({","#F8F8F2"],"\n ",["message: _response.error.errorMessage,","#F8F8F2"],"\n ",["});","#F8F8F2"],"\n",["}","#F8F8F2"],"\n",["// ...","#88846F"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"By contrast, Speakeasy creates SDKs with improved readability by breaking SDK functionality into smaller, more focused methods, without hiding important steps behind multiple layers of abstraction."}],"\n",["$","h3",null,{"id":"open-enums","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Open enums",["$","$L26",null,{"id":"open-enums"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Both Speakeasy and Fern generate SDKs that allow users to pass unknown values in fields that are defined as enums if the SDK is configured to do so. This is useful to keep legacy SDKs working when an API changes."}],"\n",["$","$L25",null,{"as":"p","children":["However, where Speakeasy SDKs clearly mark unknown enum values by wrapping them in an ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Unrecognized"}]," type, SDKs generated by Fern use a type assertion. By not marking unrecognized enum values as such, Fern undermines the type safety TypeScript users rely on."]}],"\n",["$","$L25",null,{"as":"p","children":"Consider the following OpenAPI component:"}],"\n",["$","$L2a",null,{"codeblock":{"value":"components:\n schemas:\n BackgroundColor:\n type: string\n x-speakeasy-unknown-values: allow\n enum:\n - red\n - green\n - blue","lang":"yaml","meta":"openapi.yaml","code":"components:\n schemas:\n BackgroundColor:\n type: string\n x-speakeasy-unknown-values: allow\n enum:\n - red\n - green\n - blue","tokens":[["components","#F92672"],[":","#F8F8F2"],"\n ",["schemas","#F92672"],[":","#F8F8F2"],"\n ",["BackgroundColor","#F92672"],[":","#F8F8F2"],"\n ",["type","#F92672"],[":","#F8F8F2"]," ",["string","#E6DB74"],"\n ",["x-speakeasy-unknown-values","#F92672"],[":","#F8F8F2"]," ",["allow","#E6DB74"],"\n ",["enum","#F92672"],[":","#F8F8F2"],"\n ",["-","#F8F8F2"]," ",["red","#E6DB74"],"\n ",["-","#F8F8F2"]," ",["green","#E6DB74"],"\n ",["-","#F8F8F2"]," ",["blue","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["Based on this definition, Speakeasy will allow users to set the value of the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"BackgroundColor"}]," string to ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"yellow"}],", but will mark it as unrecognized. Here’s an example of what this looks like in TypeScript:"]}],"\n",["$","$L2a",null,{"codeblock":{"value":"type BackgroundColor = \"red\" | \"green\" | \"blue\" | Unrecognized;","lang":"typescript","meta":"speakeasy/BackgroundColor.ts","code":"type BackgroundColor = \"red\" | \"green\" | \"blue\" | Unrecognized;","tokens":[["type","#66D9EF",{"fontStyle":"italic"}]," ",["BackgroundColor","#A6E22E",{"textDecoration":"underline"}]," ",["=","#F92672"]," ",["\"red\"","#E6DB74"]," ",["|","#F92672"]," ",["\"green\"","#E6DB74"]," ",["|","#F92672"]," ",["\"blue\"","#E6DB74"]," ",["|","#F92672"]," ",["Unrecognized","#A6E22E",{"textDecoration":"underline"}],["<","#F8F8F2"],["string","#66D9EF",{"fontStyle":"italic"}],[">;","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"In the Cohere SDK generated by Fern, we found this enum:"}],"\n",["$","$L2a",null,{"codeblock":{"value":"/**\n * This file was auto-generated by Fern from our API Definition.\n */\n\nimport * as Cohere from \"../../../../../../api/index\";\nimport * as core from \"../../../../../../core\";\nimport * as serializers from \"../../../../../index\";\n\nexport const Status: core.serialization.Schema<\n serializers.finetuning.Status.Raw,\n Cohere.finetuning.Status\n> = core.serialization.enum_([\n \"STATUS_UNSPECIFIED\",\n \"STATUS_FINETUNING\",\n \"STATUS_DEPLOYING_API\",\n \"STATUS_READY\",\n \"STATUS_FAILED\",\n \"STATUS_DELETED\",\n \"STATUS_TEMPORARILY_OFFLINE\",\n \"STATUS_PAUSED\",\n \"STATUS_QUEUED\",\n]);\n\nexport declare namespace Status {\n type Raw =\n | \"STATUS_UNSPECIFIED\"\n | \"STATUS_FINETUNING\"\n | \"STATUS_DEPLOYING_API\"\n | \"STATUS_READY\"\n | \"STATUS_FAILED\"\n | \"STATUS_DELETED\"\n | \"STATUS_TEMPORARILY_OFFLINE\"\n | \"STATUS_PAUSED\"\n | \"STATUS_QUEUED\";\n}","lang":"typescript","meta":"src/serialization/resources/finetuning/resources/finetuning/types/Status.ts","code":"/**\n * This file was auto-generated by Fern from our API Definition.\n */\n\nimport * as Cohere from \"../../../../../../api/index\";\nimport * as core from \"../../../../../../core\";\nimport * as serializers from \"../../../../../index\";\n\nexport const Status: core.serialization.Schema<\n serializers.finetuning.Status.Raw,\n Cohere.finetuning.Status\n> = core.serialization.enum_([\n \"STATUS_UNSPECIFIED\",\n \"STATUS_FINETUNING\",\n \"STATUS_DEPLOYING_API\",\n \"STATUS_READY\",\n \"STATUS_FAILED\",\n \"STATUS_DELETED\",\n \"STATUS_TEMPORARILY_OFFLINE\",\n \"STATUS_PAUSED\",\n \"STATUS_QUEUED\",\n]);\n\nexport declare namespace Status {\n type Raw =\n | \"STATUS_UNSPECIFIED\"\n | \"STATUS_FINETUNING\"\n | \"STATUS_DEPLOYING_API\"\n | \"STATUS_READY\"\n | \"STATUS_FAILED\"\n | \"STATUS_DELETED\"\n | \"STATUS_TEMPORARILY_OFFLINE\"\n | \"STATUS_PAUSED\"\n | \"STATUS_QUEUED\";\n}","tokens":[["/**","#88846F"],"\n ",["* This file was auto-generated by Fern from our API Definition.","#88846F"],"\n ",["*/","#88846F"],"\n\n",["import","#F92672"]," ",["*","#AE81FF"]," ",["as","#F92672"]," ",["Cohere","#F8F8F2"]," ",["from","#F92672"]," ",["\"../../../../../../api/index\"","#E6DB74"],[";","#F8F8F2"],"\n",["import","#F92672"]," ",["*","#AE81FF"]," ",["as","#F92672"]," ",["core","#F8F8F2"]," ",["from","#F92672"]," ",["\"../../../../../../core\"","#E6DB74"],[";","#F8F8F2"],"\n",["import","#F92672"]," ",["*","#AE81FF"]," ",["as","#F92672"]," ",["serializers","#F8F8F2"]," ",["from","#F92672"]," ",["\"../../../../../index\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["export","#F92672"]," ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["Status","#F8F8F2"],[":","#F92672"]," ",["core","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["serialization","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["Schema","#A6E22E",{"textDecoration":"underline"}],["<","#F8F8F2"],"\n ",["serializers","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["finetuning","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["Status","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["Raw","#A6E22E",{"textDecoration":"underline"}],[",","#F8F8F2"],"\n ",["Cohere","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["finetuning","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["Status","#A6E22E",{"textDecoration":"underline"}],"\n",[">","#F8F8F2"]," ",["=","#F92672"]," ",["core.serialization.","#F8F8F2"],["enum_","#A6E22E"],["([","#F8F8F2"],"\n ",["\"STATUS_UNSPECIFIED\"","#E6DB74"],[",","#F8F8F2"],"\n ",["\"STATUS_FINETUNING\"","#E6DB74"],[",","#F8F8F2"],"\n ",["\"STATUS_DEPLOYING_API\"","#E6DB74"],[",","#F8F8F2"],"\n ",["\"STATUS_READY\"","#E6DB74"],[",","#F8F8F2"],"\n ",["\"STATUS_FAILED\"","#E6DB74"],[",","#F8F8F2"],"\n ",["\"STATUS_DELETED\"","#E6DB74"],[",","#F8F8F2"],"\n ",["\"STATUS_TEMPORARILY_OFFLINE\"","#E6DB74"],[",","#F8F8F2"],"\n ",["\"STATUS_PAUSED\"","#E6DB74"],[",","#F8F8F2"],"\n ",["\"STATUS_QUEUED\"","#E6DB74"],[",","#F8F8F2"],"\n",["]);","#F8F8F2"],"\n\n",["export declare","#F92672"]," ",["namespace","#66D9EF",{"fontStyle":"italic"}]," ",["Status","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["type","#66D9EF",{"fontStyle":"italic"}]," ",["Raw","#A6E22E",{"textDecoration":"underline"}]," ",["=","#F92672"],"\n ",["|","#F92672"]," ",["\"STATUS_UNSPECIFIED\"","#E6DB74"],"\n ",["|","#F92672"]," ",["\"STATUS_FINETUNING\"","#E6DB74"],"\n ",["|","#F92672"]," ",["\"STATUS_DEPLOYING_API\"","#E6DB74"],"\n ",["|","#F92672"]," ",["\"STATUS_READY\"","#E6DB74"],"\n ",["|","#F92672"]," ",["\"STATUS_FAILED\"","#E6DB74"],"\n ",["|","#F92672"]," ",["\"STATUS_DELETED\"","#E6DB74"],"\n ",["|","#F92672"]," ",["\"STATUS_TEMPORARILY_OFFLINE\"","#E6DB74"],"\n ",["|","#F92672"]," ",["\"STATUS_PAUSED\"","#E6DB74"],"\n ",["|","#F92672"]," ",["\"STATUS_QUEUED\"","#E6DB74"],[";","#F8F8F2"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["When we looked at the definition of ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"core.serialization.enum_"}],", we found that any string value can be passed as a status, and would be represented as type ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Status"}],"."]}],"\n",["$","h2",null,{"id":"sdk-and-bundle-size","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["SDK and bundle size",["$","$L26",null,{"id":"sdk-and-bundle-size"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Both Speakeasy and Fern SDKs include runtime data validation, which can increase the bundle size. However, Speakeasy SDKs are designed to be tree-shakable, so you can remove any unused code from the SDK before bundling it."}],"\n",["$","$L25",null,{"as":"p","children":"Speakeasy also exposes a standalone function for each API call, which allows you to import only the functions you need, further reducing the bundle size."}],"\n",["$","h3",null,{"id":"creating-bundles","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Creating bundles",["$","$L26",null,{"id":"creating-bundles"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Let’s compare the bundle sizes of the SDKs generated by Speakeasy and Fern."}],"\n",["$","$L25",null,{"as":"p","children":["Start by adding a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"speakeasy.ts"}]," file that imports the Speakeasy SDK:"]}],"\n",["$","$L2a",null,{"codeblock":{"value":"import { SDKCore } from \"./bar-sdk-speakeasy/src/core\";\nimport { drinksListDrinks } from \"./bar-sdk-speakeasy/src/funcs/drinksListDrinks\";\n\n// Use `SDKCore` for best tree-shaking performance.\n// You can create one instance of it to use across an application.\nconst sdk = new SDKCore();\n\nasync function run() {\n const res = await drinksListDrinks(sdk, {});\n\n if (!res.ok) {\n throw res.error;\n }\n\n const { value: result } = res;\n\n // Handle the result\n console.log(result);\n}\n\nrun();","lang":"typescript","meta":"speakeasy.ts","code":"import { SDKCore } from \"./bar-sdk-speakeasy/src/core\";\nimport { drinksListDrinks } from \"./bar-sdk-speakeasy/src/funcs/drinksListDrinks\";\n\n// Use `SDKCore` for best tree-shaking performance.\n// You can create one instance of it to use across an application.\nconst sdk = new SDKCore();\n\nasync function run() {\n const res = await drinksListDrinks(sdk, {});\n\n if (!res.ok) {\n throw res.error;\n }\n\n const { value: result } = res;\n\n // Handle the result\n console.log(result);\n}\n\nrun();","tokens":[["import","#F92672"]," ",["{ SDKCore }","#F8F8F2"]," ",["from","#F92672"]," ",["\"./bar-sdk-speakeasy/src/core\"","#E6DB74"],[";","#F8F8F2"],"\n",["import","#F92672"]," ",["{ drinksListDrinks }","#F8F8F2"]," ",["from","#F92672"]," ",["\"./bar-sdk-speakeasy/src/funcs/drinksListDrinks\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["// Use `SDKCore` for best tree-shaking performance.","#88846F"],"\n",["// You can create one instance of it to use across an application.","#88846F"],"\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["sdk","#F8F8F2"]," ",["= new","#F92672"]," ",["SDKCore","#A6E22E"],["();","#F8F8F2"],"\n\n",["async","#F92672"]," ",["function","#66D9EF",{"fontStyle":"italic"}]," ",["run","#A6E22E"],["() {","#F8F8F2"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["res","#F8F8F2"]," ",["= await","#F92672"]," ",["drinksListDrinks","#A6E22E"],["(sdk, {});","#F8F8F2"],"\n\n ",["if","#F92672"]," ",["(","#F8F8F2"],["!","#F92672"],["res.ok) {","#F8F8F2"],"\n ",["throw","#F92672"]," ",["res.error;","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["{ value: result }","#F8F8F2"]," ",["=","#F92672"]," ",["res;","#F8F8F2"],"\n\n ",["// Handle the result","#88846F"],"\n ",["console.","#F8F8F2"],["log","#A6E22E"],["(result);","#F8F8F2"],"\n",["}","#F8F8F2"],"\n\n",["run","#A6E22E"],["();","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["Next, add a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"fern.ts"}]," file that imports the Fern SDK:"]}],"\n",["$","$L2a",null,{"codeblock":{"value":"import { NdimaresApiClient } from \"./generated/typescript\";\n\n// Create an instance of the Fern SDK client\nconst client = new NdimaresApiClient({\n apiKey: \"YOUR_API_KEY\",\n});\n\nasync function run() {\n try {\n // Use the drinks.listDrinks() method to get the list of drinks\n const result = await client.drinks.listDrinks();\n\n // Handle the result\n console.log(result);\n } catch (error) {\n console.error(\"An error occurred:\", error);\n }\n}\n\nrun();","lang":"typescript","meta":"fern.ts","code":"import { NdimaresApiClient } from \"./generated/typescript\";\n\n// Create an instance of the Fern SDK client\nconst client = new NdimaresApiClient({\n apiKey: \"YOUR_API_KEY\",\n});\n\nasync function run() {\n try {\n // Use the drinks.listDrinks() method to get the list of drinks\n const result = await client.drinks.listDrinks();\n\n // Handle the result\n console.log(result);\n } catch (error) {\n console.error(\"An error occurred:\", error);\n }\n}\n\nrun();","tokens":[["import","#F92672"]," ",["{ NdimaresApiClient }","#F8F8F2"]," ",["from","#F92672"]," ",["\"./generated/typescript\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["// Create an instance of the Fern SDK client","#88846F"],"\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["client","#F8F8F2"]," ",["= new","#F92672"]," ",["NdimaresApiClient","#A6E22E"],["({","#F8F8F2"],"\n ",["apiKey:","#F8F8F2"]," ",["\"YOUR_API_KEY\"","#E6DB74"],[",","#F8F8F2"],"\n",["});","#F8F8F2"],"\n\n",["async","#F92672"]," ",["function","#66D9EF",{"fontStyle":"italic"}]," ",["run","#A6E22E"],["() {","#F8F8F2"],"\n ",["try","#F92672"]," ",["{","#F8F8F2"],"\n ",["// Use the drinks.listDrinks() method to get the list of drinks","#88846F"],"\n ",["const","#66D9EF",{"fontStyle":"italic"}]," ",["result","#F8F8F2"]," ",["= await","#F92672"]," ",["client.drinks.","#F8F8F2"],["listDrinks","#A6E22E"],["();","#F8F8F2"],"\n\n ",["// Handle the result","#88846F"],"\n ",["console.","#F8F8F2"],["log","#A6E22E"],["(result);","#F8F8F2"],"\n ",["}","#F8F8F2"]," ",["catch","#F92672"]," ",["(error) {","#F8F8F2"],"\n ",["console.","#F8F8F2"],["error","#A6E22E"],["(","#F8F8F2"],["\"An error occurred:\"","#E6DB74"],[", error);","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n",["}","#F8F8F2"],"\n\n",["run","#A6E22E"],["();","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"We’ll use esbuild to bundle the SDKs. First, install esbuild:"}],"\n",["$","$L2a",null,{"codeblock":{"value":"npm install esbuild","lang":"shellscript","meta":"","code":"npm install esbuild","tokens":[["npm","#A6E22E"]," ",["install esbuild","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["Next, add a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"build.js"}]," script that uses esbuild to bundle the SDKs:"]}],"\n",["$","$L2a",null,{"codeblock":{"value":"import * as fs from \"fs\";\nimport * as esbuild from \"esbuild\";\n\nconst speakeasyBuild = await esbuild.build({\n entryPoints: [\"speakeasy.ts\"],\n outfile: \"dist/speakeasy.js\",\n bundle: true,\n minify: true,\n treeShaking: true,\n metafile: true,\n target: \"node18\",\n platform: \"node\",\n});\n\nfs.writeFileSync(\n \"dist/speakeasy.json\",\n JSON.stringify(speakeasyBuild.metafile, null, 2),\n);\n\nconst fernBuild = await esbuild.build({\n entryPoints: [\"fern.ts\"],\n outfile: \"dist/fern.js\",\n bundle: true,\n minify: true,\n treeShaking: true,\n metafile: true,\n target: \"node18\",\n platform: \"node\",\n});\n\nfs.writeFileSync(\"dist/fern.json\", JSON.stringify(fernBuild.metafile, null, 2));","lang":"typescript","meta":"build.js","code":"import * as fs from \"fs\";\nimport * as esbuild from \"esbuild\";\n\nconst speakeasyBuild = await esbuild.build({\n entryPoints: [\"speakeasy.ts\"],\n outfile: \"dist/speakeasy.js\",\n bundle: true,\n minify: true,\n treeShaking: true,\n metafile: true,\n target: \"node18\",\n platform: \"node\",\n});\n\nfs.writeFileSync(\n \"dist/speakeasy.json\",\n JSON.stringify(speakeasyBuild.metafile, null, 2),\n);\n\nconst fernBuild = await esbuild.build({\n entryPoints: [\"fern.ts\"],\n outfile: \"dist/fern.js\",\n bundle: true,\n minify: true,\n treeShaking: true,\n metafile: true,\n target: \"node18\",\n platform: \"node\",\n});\n\nfs.writeFileSync(\"dist/fern.json\", JSON.stringify(fernBuild.metafile, null, 2));","tokens":[["import","#F92672"]," ",["*","#AE81FF"]," ",["as","#F92672"]," ",["fs","#F8F8F2"]," ",["from","#F92672"]," ",["\"fs\"","#E6DB74"],[";","#F8F8F2"],"\n",["import","#F92672"]," ",["*","#AE81FF"]," ",["as","#F92672"]," ",["esbuild","#F8F8F2"]," ",["from","#F92672"]," ",["\"esbuild\"","#E6DB74"],[";","#F8F8F2"],"\n\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["speakeasyBuild","#F8F8F2"]," ",["= await","#F92672"]," ",["esbuild.","#F8F8F2"],["build","#A6E22E"],["({","#F8F8F2"],"\n ",["entryPoints: [","#F8F8F2"],["\"speakeasy.ts\"","#E6DB74"],["],","#F8F8F2"],"\n ",["outfile:","#F8F8F2"]," ",["\"dist/speakeasy.js\"","#E6DB74"],[",","#F8F8F2"],"\n ",["bundle:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["minify:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["treeShaking:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["metafile:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["target:","#F8F8F2"]," ",["\"node18\"","#E6DB74"],[",","#F8F8F2"],"\n ",["platform:","#F8F8F2"]," ",["\"node\"","#E6DB74"],[",","#F8F8F2"],"\n",["});","#F8F8F2"],"\n\n",["fs.","#F8F8F2"],["writeFileSync","#A6E22E"],["(","#F8F8F2"],"\n ",["\"dist/speakeasy.json\"","#E6DB74"],[",","#F8F8F2"],"\n ",["JSON.","#F8F8F2"],["stringify","#A6E22E"],["(speakeasyBuild.metafile,","#F8F8F2"]," ",["null","#AE81FF"],[",","#F8F8F2"]," ",["2","#AE81FF"],["),","#F8F8F2"],"\n",[");","#F8F8F2"],"\n\n",["const","#66D9EF",{"fontStyle":"italic"}]," ",["fernBuild","#F8F8F2"]," ",["= await","#F92672"]," ",["esbuild.","#F8F8F2"],["build","#A6E22E"],["({","#F8F8F2"],"\n ",["entryPoints: [","#F8F8F2"],["\"fern.ts\"","#E6DB74"],["],","#F8F8F2"],"\n ",["outfile:","#F8F8F2"]," ",["\"dist/fern.js\"","#E6DB74"],[",","#F8F8F2"],"\n ",["bundle:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["minify:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["treeShaking:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["metafile:","#F8F8F2"]," ",["true","#AE81FF"],[",","#F8F8F2"],"\n ",["target:","#F8F8F2"]," ",["\"node18\"","#E6DB74"],[",","#F8F8F2"],"\n ",["platform:","#F8F8F2"]," ",["\"node\"","#E6DB74"],[",","#F8F8F2"],"\n",["});","#F8F8F2"],"\n\n",["fs.","#F8F8F2"],["writeFileSync","#A6E22E"],["(","#F8F8F2"],["\"dist/fern.json\"","#E6DB74"],[", JSON.","#F8F8F2"],["stringify","#A6E22E"],["(fernBuild.metafile,","#F8F8F2"]," ",["null","#AE81FF"],[",","#F8F8F2"]," ",["2","#AE81FF"],["));","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["Run the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"build.js"}]," script:"]}],"\n",["$","$L2a",null,{"codeblock":{"value":"node build.js","lang":"shellscript","meta":"","code":"node build.js","tokens":[["node","#A6E22E"]," ",["build.js","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["This generates two bundles, ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"dist/speakeasy.js"}]," and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"dist/fern.js"}],", along with their respective metafiles."]}],"\n",["$","h3",null,{"id":"bundle-size-comparison","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Bundle size comparison",["$","$L26",null,{"id":"bundle-size-comparison"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Now that we have two bundles, let’s compare their sizes."}],"\n",["$","$L25",null,{"as":"p","children":["First, let’s look at the size of the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"dist/speakeasy.js"}]," bundle:"]}],"\n",["$","$L2a",null,{"codeblock":{"value":"du -sh dist/speakeasy.js\n# Output\n# 76K dist/speakeasy.js","lang":"shellscript","meta":"","code":"du -sh dist/speakeasy.js\n# Output\n# 76K dist/speakeasy.js","tokens":[["du","#A6E22E"]," ",["-sh","#AE81FF"]," ",["dist/speakeasy.js","#E6DB74"],"\n",["# Output","#88846F"],"\n",["# 76K dist/speakeasy.js","#88846F"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["Next, let’s look at the size of the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"dist/fern.js"}]," bundle:"]}],"\n",["$","$L2a",null,{"codeblock":{"value":"du -sh dist/fern.js\n# Output\n# 232K dist/fern.js","lang":"shellscript","meta":"","code":"du -sh dist/fern.js\n# Output\n# 232K dist/fern.js","tokens":[["du","#A6E22E"]," ",["-sh","#AE81FF"]," ",["dist/fern.js","#E6DB74"],"\n",["# Output","#88846F"],"\n",["# 232K dist/fern.js","#88846F"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"The SDK generated by Fern is significantly larger than that built with the SDK generated by Speakeasy."}],"\n",["$","$L25",null,{"as":"p","children":"We can use the metafiles generated by esbuild to analyze the bundle sizes in more detail."}],"\n",["$","h3",null,{"id":"analyzing-bundle-sizes","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Analyzing bundle sizes",["$","$L26",null,{"id":"analyzing-bundle-sizes"}]]}],"\n",["$","$L25",null,{"as":"p","children":"The metafiles generated by esbuild contain detailed information about which source files contribute to each bundle’s size, presented as a tree structure."}],"\n",["$","$L25",null,{"as":"p","children":["We used esbuild’s online ",["$","a",null,{"href":"https://esbuild.github.io/analyze/","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["bundle visualizer",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}]," to analyze the bundle sizes."]}],"\n",["$","$L25",null,{"as":"p","children":"Here’s a summary of the bundle sizes:"}],"\n",["$","$L25",null,{"as":"p","children":["The ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"dist/speakeasy.js"}]," bundle’s largest contributor, at 72.3%, is the Zod library used for runtime data validation. The Zod library’s tree-shaking capabilities are a work in progress, and future versions of SDKs are expected to have smaller bundle sizes."]}],"\n",["$","$L25",null,{"as":"p","children":["$","$L29",null,{"alt":"Speakeasy bundle size","placeholder":"blur","src":{"src":"/_next/static/media/speakeasy-bundle-size.d9e1124c.png","height":1309,"width":2633,"blurDataURL":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAECAMAAACEE47CAAAANlBMVEUvyEc0uFBLw3VYkVRWq2os1ESniNQ1zlAzvUxQy3zCRcTCXeDcGonSDE/AEi1JzXRlu5HsLsRPAQT0AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAKUlEQVR4nGPg5ORk4hdgY2MAAVYWbi4GdnZ2dlYWQR4GRg4ODgZmXj4AD3wA4HZG560AAAAASUVORK5CYII=","blurWidth":8,"blurHeight":4}}]}],"\n",["$","$L25",null,{"as":"p","children":["The ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"dist/fern.js"}]," bundle includes bundled versions of ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"node-fetch"}],", polyfills, and other dependencies, which contribute to the larger bundle size. Fern’s SDKs also include custom serialization code and a validation library, which can increase the bundle size."]}],"\n",["$","$L25",null,{"as":"p","children":["$","$L29",null,{"alt":"Fern bundle size","placeholder":"blur","src":{"src":"/_next/static/media/fern-bundle-size.dc69101d.png","height":1308,"width":2631,"blurDataURL":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAgAAAAECAMAAACEE47CAAAASFBMVEXUrxhyjcZAv2I3wlSQjdKuVMDJGEnsvhTstwrAvUJTtjdSxkVxqZVywlSqeMdWpJmGasFIsaqUW5uWZr9Ktn7GEXPHQbRGyrWykLCEAAAACXBIWXMAAAsTAAALEwEAmpwYAAAALElEQVR4nGPg5OTl5mFh4WPg4OBi5mcUYGVgZ2cSZxRmFWNgYBARFBJlYwMAFQIBPWZFq5oAAAAASUVORK5CYII=","blurWidth":8,"blurHeight":4}}]}],"\n",["$","h3",null,{"id":"bundling-for-the-browser","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-8 x:text-2xl","children":["Bundling for the browser",["$","$L26",null,{"id":"bundling-for-the-browser"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Speakeasy SDKs are designed to work in a range of environments, including the browser. To bundle an SDK for the browser, you can use a tool like esbuild or webpack."}],"\n",["$","$L25",null,{"as":"p","children":"Here’s an example of how to bundle the Speakeasy SDK for the browser using esbuild:"}],"\n",["$","$L2a",null,{"codeblock":{"value":"npx esbuild src/speakeasy.ts --bundle --minify --target=es2020 --platform=browser --outfile=dist/speakeasy-web.js","lang":"shellscript","meta":"","code":"npx esbuild src/speakeasy.ts --bundle --minify --target=es2020 --platform=browser --outfile=dist/speakeasy-web.js","tokens":[["npx","#A6E22E"]," ",["esbuild src/speakeasy.ts","#E6DB74"]," ",["--bundle --minify --target=es2020 --platform=browser --outfile=dist/speakeasy-web.js","#AE81FF"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"Doing the same for the Fern SDK generates an error, as the SDK is not designed to work in the browser out of the box."}],"\n",["$","h2",null,{"id":"summary","className":"x:tracking-tight x:text-slate-900 x:dark:text-slate-100 x:font-semibold x:target:animate-[fade-in_1.5s] x:mt-10 x:border-b x:pb-1 x:text-3xl nextra-border","children":["Summary",["$","$L26",null,{"id":"summary"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Speakeasy’s additional language support and SDK documentation make it a better choice than Fern for most users."}],"\n",["$","$L25",null,{"as":"p","children":["If you are interested in seeing how Speakeasy stacks up against other SDK generation tools, check out our ",["$","a",null,{"href":"https://www.speakeasy.com/post/compare-speakeasy-open-source","target":"_blank","rel":"noreferrer","className":"x:focus-visible:nextra-focus x:text-primary-600 x:underline x:hover:no-underline x:decoration-from-font x:[text-underline-position:from-font]","children":["post",[" ",["$","svg",null,{"fill":"none","stroke":"currentColor","strokeLinecap":"round","strokeLinejoin":"round","strokeWidth":1.7,"viewBox":"0 0 24 24","height":"1em","className":"x:inline x:align-baseline x:shrink-0","children":[["$","path",null,{"d":"M7 17L17 7"}],["$","path",null,{"d":"M7 7h10v10"}]]}]]]}],"."]}]]]}]]}]]}]}],false]