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:48"]}],["$","div",null,{"className":"docs-layout-default docs-content blog","children":["$","$L21",null,{"value":[{"value":"What Is a Terraform Provider?","id":"what-is-a-terraform-provider","depth":2},{"value":"Why Build a Terraform Provider for an API?","id":"why-build-a-terraform-provider-for-an-api","depth":2},{"value":"About Terraform Providers","id":"about-terraform-providers","depth":2},{"value":"Generating a Terraform Provider","id":"generating-a-terraform-provider","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":3},{"value":"Create a Terraform Provider With the HashiCorp Provider Spec Generator","id":"create-a-terraform-provider-with-the-hashicorp-provider-spec-generator","depth":2},{"value":"The HashiCorp Workflow Example","id":"the-hashicorp-workflow-example","depth":3},{"value":"Create a Terraform Provider With Speakeasy","id":"create-a-terraform-provider-with-speakeasy","depth":2},{"value":"Add Speakeasy Terraform Annotations","id":"add-speakeasy-terraform-annotations","depth":3},{"value":"Speakeasy Security Support","id":"speakeasy-security-support","depth":4},{"value":"Install the Terraform Provider","id":"install-the-terraform-provider","depth":3},{"value":"Call the Provider From Terraform","id":"call-the-provider-from-terraform","depth":3},{"value":"Summary of the Speakeasy Terraform Provider Creation Process","id":"summary-of-the-speakeasy-terraform-provider-creation-process","depth":3},{"value":"Comparison and Conclusion","id":"comparison-and-conclusion","depth":2},{"value":"Further Reading","id":"further-reading","depth":2},{"value":"HashiCorp Automated Terraform Provider Creation","id":"hashicorp-automated-terraform-provider-creation","depth":3},{"value":"Speakeasy Automated Terraform Provider Creation","id":"speakeasy-automated-terraform-provider-creation","depth":3}],"children":[["$","$L22",null,{}],["$","$L23",null,{"metadata":{"title":"How to Generate Terraform Providers","filePath":"src/content/blog/how-to-build-terraform-providers/index.mdx","description":"How to create a Terraform provider automatically from an OpenAPI/Swagger Document with Speakeasy, and how it compares to using the new HashiCorp codegen framework.","keywords":["go","golang","HashiCorp","Terraform","OAS","OpenAPI","schema","provider"],"image":"/assets/how-to-build-terraform-providers.png","date":"2024-02-21","authors":[{"name":"Thomas Rooney"},{"image_url":"/assets/author-headshots/thomas.jpeg"}],"tags":["Terraform"],"featured_image":"/assets/how-to-build-terraform-providers.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":368,"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:49: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,[["$","$L25",null,{"as":"p","children":"HashiCorp (creators of Terraform) recently released a tool for automatically creating Terraform provider data types from your OpenAPI documents. In this post we’ll do a full walkthrough of how to use both of these tools, but before getting into the details, here’s a high level summary of the differences between the two:"}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":"Requires a separate, custom generation configuration. Speakeasy uses the built-in OpenAPI Specification extensions mechanism to define Terraform Provider resources and data modeling. (Both must be handwritten today, but we could make a product decision to enable better UX.)"}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Only creates Terraform schema and data handling types. There is no code generation for the underlying code to handle API requests/responses, implement API security, nor Terraform Provider resource logic. Speakeasy does everything (works out of the box)."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["Does not support the full OpenAPI Specification data handling system. Speakeasy supports OAS schemas including advanced features, such as ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"oneOf"}]," and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"allOf"}],"."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Has only received dependency maintenance updates since January 2024. Speakeasy is actively maintained and enhanced."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Because the Speakeasy workflow is end to end, it is easy to fully automate the generation. Speakeasy has a Github Action that can easily be added to your CI/CD. Hashicorp would require a custom script to pull together a couple of tools in order to fully automate the generation."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"In contrast to Speakeasy’s “OpenAPI-first” philosophy, HashiCorp uses an intermediate format between the OpenAPI schema and the provider. This format is theoretically useful if you want to create a provider with something other than OpenAPI, such as directly from your API codebase. But in that case, you probably would need to write a custom script, as there is no tool for this yet."}],"\n"]}],"\n",["$","$L25",null,{"as":"p","children":["For those who need it, let’s start with a brief overview of Terraform providers and how they work. Otherwise, you can skip ahead to ",["$","a",null,{"href":"#generating-a-terraform-provider","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":"Generating a Terraform Provider"}]]}],"\n",["$","h2",null,{"id":"what-is-a-terraform-provider","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":["What Is a Terraform Provider?",["$","$L26",null,{"id":"what-is-a-terraform-provider"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Terraform is a free tool to manage infrastructure with configuration files. For instance, you can call Terraform to create identical AWS servers ready to run an application in development, test, and production environments by giving it the same configuration file for each environment. A Terraform provider is a plugin to the Terraform core software that allows Terraform to access resources that live in a 3rd party system (for example, the AWS provider allows access to AWS, the system that manages cloud infrastructure resources)."}],"\n",["$","h2",null,{"id":"why-build-a-terraform-provider-for-an-api","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":["Why Build a Terraform Provider for an API?",["$","$L26",null,{"id":"why-build-a-terraform-provider-for-an-api"}]]}],"\n",["$","$L25",null,{"as":"p","children":"If your API calls a stateless service (to get a share price, for instance, or charge a credit card), there is nothing for configuration files to manage. However, if your API manages any resource that persists (like user permissions or an accounting system), you could offer your users a custom Terraform provider as an interface to your API, allowing them to call your service through a standard set of configuration files."}],"\n",["$","$L25",null,{"as":"p","children":["For a more thorough conversation of Terraform providers and examples, see our article on the ",["$","$L27",null,{"href":"/post/build-terraform-providers","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":"benefits of Terraform providers"}],"."]}],"\n",["$","h2",null,{"id":"about-terraform-providers","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":["About Terraform Providers",["$","$L26",null,{"id":"about-terraform-providers"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Terraform providers are modules written in Go as plugins for Terraform."}],"\n",["$","$L25",null,{"as":"p","children":["When you install a Terraform provider with ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"go install"}],", it is saved to the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"go"}]," path, for example, ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"root/go/bin"}],"."]}],"\n",["$","$L25",null,{"as":"p","children":["The Terraform provider filename will match the first line in the module’s ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"go.mod"}]," file. For example, the following:"]}],"\n",["$","$L28",null,{"codeblock":{"value":"module github.com/speakeasy/terraform-provider-terraform","lang":"go","meta":"","code":"module github.com/speakeasy/terraform-provider-terraform","tokens":[["module github.com","#F8F8F2"],["/","#F92672"],["speakeasy","#F8F8F2"],["/","#F92672"],["terraform","#F8F8F2"],["-","#F92672"],["provider","#F8F8F2"],["-","#F92672"],["terraform","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["Will match the file ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"root/go/bin/terraform-provider-terraform"}],"."]}],"\n",["$","$L25",null,{"as":"p","children":["However, the name you use for the provider in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"source"}]," field of the Terraform resource configuration file comes from your module’s ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"main.go"}]," file. In this excerpt:"]}],"\n",["$","$L28",null,{"codeblock":{"value":"terraform {\n required_providers {\n terraform = {\n source = \"speakeasy/terraform\"\n version = \"0.0.3\"\n }\n }\n}","lang":"hcl","meta":"","code":"terraform {\n required_providers {\n terraform = {\n source = \"speakeasy/terraform\"\n version = \"0.0.3\"\n }\n }\n}","tokens":[["terraform","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["required_providers","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["terraform","#F8F8F2"]," ",["=","#F92672"]," ",["{","#F8F8F2"],"\n ",["source","#F8F8F2"]," ",["=","#F92672"]," ",["\"speakeasy/terraform\"","#E6DB74"],"\n ",["version","#F8F8F2"]," ",["=","#F92672"]," ",["\"0.0.3\"","#E6DB74"],"\n ",["}","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["The name used in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"source"}]," field comes from the module’s ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"main.go"}]," file:"]}],"\n",["$","$L28",null,{"codeblock":{"value":"\topts := providerserver.ServeOpts{\n\t\tAddress: \"registry.terraform.io/speakeasy/terraform\",","lang":"go","meta":"","code":"\topts := providerserver.ServeOpts{\n\t\tAddress: \"registry.terraform.io/speakeasy/terraform\",","tokens":["\t",["opts","#F8F8F2"]," ",[":=","#F92672"]," ",["providerserver","#A6E22E",{"textDecoration":"underline"}],[".","#F8F8F2"],["ServeOpts","#A6E22E",{"textDecoration":"underline"}],["{","#F8F8F2"],"\n\t\t",["Address:","#F8F8F2"]," ",["\"registry.terraform.io/speakeasy/terraform\"","#E6DB74"],[",","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["When building and testing Speakeasy and HashiCorp providers locally, you need to match your Terraform repository overrides to the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"main.go"}]," field in ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":".terraformrc"}],":"]}],"\n",["$","$L28",null,{"codeblock":{"value":"provider_installation {\n dev_overrides {\n \"speakeasy/terraform\" = \"/root/go/bin\"\n \"terraform-provider-petstore\" = \"/root/go/bin\"\n }\n direct {}\n}","lang":"hcl","meta":"","code":"provider_installation {\n dev_overrides {\n \"speakeasy/terraform\" = \"/root/go/bin\"\n \"terraform-provider-petstore\" = \"/root/go/bin\"\n }\n direct {}\n}","tokens":[["provider_installation","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["dev_overrides","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["\"speakeasy/terraform\"","#E6DB74"]," ",["=","#F8F8F2"]," ",["\"/root/go/bin\"","#E6DB74"],"\n ",["\"terraform-provider-petstore\"","#E6DB74"]," ",["=","#F8F8F2"]," ",["\"/root/go/bin\"","#E6DB74"],"\n ",["}","#F8F8F2"],"\n ",["direct","#A6E22E",{"textDecoration":"underline"}]," ",["{}","#F8F8F2"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","h2",null,{"id":"generating-a-terraform-provider","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":["Generating a Terraform Provider",["$","$L26",null,{"id":"generating-a-terraform-provider"}]]}],"\n",["$","h3",null,{"id":"prerequisites","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":["Prerequisites",["$","$L26",null,{"id":"prerequisites"}]]}],"\n",["$","$L25",null,{"as":"p","children":["If you would like to create a Terraform provider by following this tutorial, you’ll need ",["$","a",null,{"href":"https://docs.docker.com/get-docker","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":["Docker",[" ",["$","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"}]]}]]]}]," installed. Alternatively, you can install Go, Node.js, Speakeasy, Terraform, and the Terraform provider creation modules on your local machine."]}],"\n",["$","$L25",null,{"as":"p","children":["Below is a Dockerfile that creates an image prepared with Go, Terraform, Speakeasy, and the new HashiCorp codegen framework that you can use to run all the code in this article. Replace the Speakeasy key with your own on line nine and save the file as ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"Dockerfile"}],"."]}],"\n",["$","$L28",null,{"codeblock":{"value":"FROM --platform=linux/amd64 alpine:3.19\n\nWORKDIR /workspace\n\nRUN apk add go curl unzip bash sudo nodejs npm vim\n\nENV GOPATH=/root/go\nENV PATH=$PATH:$GOPATH/bin\nENV SPEAKEASY_API_KEY=SET_YOUR_API_KEY_HERE\n\n# install terraform:\nRUN curl -O https://releases.hashicorp.com/terraform/1.7.0/terraform_1.7.0_linux_amd64.zip && \\\n unzip terraform_1.7.0_linux_amd64.zip && \\\n mv terraform /usr/local/bin/ && \\\n rm terraform_1.7.0_linux_amd64.zip\n\n# install openapi terraform provider framework:\nRUN go install github.com/hashicorp/terraform-plugin-codegen-framework/cmd/tfplugingen-framework@latest\nRUN go install github.com/hashicorp/terraform-plugin-codegen-openapi/cmd/tfplugingen-openapi@latest\n\n# install speakeasy\nRUN curl -fsSL https://go.speakeasy.com/cli-install.sh | sh","lang":"shellscript","meta":"","code":"FROM --platform=linux/amd64 alpine:3.19\n\nWORKDIR /workspace\n\nRUN apk add go curl unzip bash sudo nodejs npm vim\n\nENV GOPATH=/root/go\nENV PATH=$PATH:$GOPATH/bin\nENV SPEAKEASY_API_KEY=SET_YOUR_API_KEY_HERE\n\n# install terraform:\nRUN curl -O https://releases.hashicorp.com/terraform/1.7.0/terraform_1.7.0_linux_amd64.zip && \\\n unzip terraform_1.7.0_linux_amd64.zip && \\\n mv terraform /usr/local/bin/ && \\\n rm terraform_1.7.0_linux_amd64.zip\n\n# install openapi terraform provider framework:\nRUN go install github.com/hashicorp/terraform-plugin-codegen-framework/cmd/tfplugingen-framework@latest\nRUN go install github.com/hashicorp/terraform-plugin-codegen-openapi/cmd/tfplugingen-openapi@latest\n\n# install speakeasy\nRUN curl -fsSL https://go.speakeasy.com/cli-install.sh | sh","tokens":[["FROM","#A6E22E"]," ",["--platform=linux/amd64","#AE81FF"]," ",["alpine:3.19","#E6DB74"],"\n\n",["WORKDIR","#A6E22E"]," ",["/workspace","#E6DB74"],"\n\n",["RUN","#A6E22E"]," ",["apk add go curl unzip bash sudo nodejs npm vim","#E6DB74"],"\n\n",["ENV","#A6E22E"]," ",["GOPATH=/root/go","#E6DB74"],"\n",["ENV","#A6E22E"]," ",["PATH=","#E6DB74"],["$$PATH","#F8F8F2"],[":","#E6DB74"],["$$GOPATH","#F8F8F2"],["/bin","#E6DB74"],"\n",["ENV","#A6E22E"]," ",["SPEAKEASY_API_KEY=SET_YOUR_API_KEY_HERE","#E6DB74"],"\n\n",["# install terraform:","#88846F"],"\n",["RUN","#A6E22E"]," ",["curl","#E6DB74"]," ",["-O","#AE81FF"]," ",["https://releases.hashicorp.com/terraform/1.7.0/terraform_1.7.0_linux_amd64.zip","#E6DB74"]," ",["&&","#F8F8F2"]," ",["\\","#AE81FF"],"\n ",["unzip","#A6E22E"]," ",["terraform_1.7.0_linux_amd64.zip","#E6DB74"]," ",["&&","#F8F8F2"]," ",["\\","#AE81FF"],"\n ",["mv","#A6E22E"]," ",["terraform /usr/local/bin/","#E6DB74"]," ",["&&","#F8F8F2"]," ",["\\","#AE81FF"],"\n ",["rm","#A6E22E"]," ",["terraform_1.7.0_linux_amd64.zip","#E6DB74"],"\n\n",["# install openapi terraform provider framework:","#88846F"],"\n",["RUN","#A6E22E"]," ",["go install github.com/hashicorp/terraform-plugin-codegen-framework/cmd/tfplugingen-framework@latest","#E6DB74"],"\n",["RUN","#A6E22E"]," ",["go install github.com/hashicorp/terraform-plugin-codegen-openapi/cmd/tfplugingen-openapi@latest","#E6DB74"],"\n\n",["# install speakeasy","#88846F"],"\n",["RUN","#A6E22E"]," ",["curl","#E6DB74"]," ",["-fsSL","#AE81FF"]," ",["https://go.speakeasy.com/cli-install.sh","#E6DB74"]," ",["|","#F92672"]," ",["sh","#A6E22E"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"Run the following commands in a terminal to start using the Dockerfile:"}],"\n",["$","$L28",null,{"codeblock":{"value":"mkdir code\ndocker build -t seimage . # build the image\ndocker run -it --volume ./code:/workspace --name sebox seimage # run the container using the code folder to work in\n\n# Run this command if you need to start the container again later:\n# docker start -ai sebox","lang":"shellscript","meta":"","code":"mkdir code\ndocker build -t seimage . # build the image\ndocker run -it --volume ./code:/workspace --name sebox seimage # run the container using the code folder to work in\n\n# Run this command if you need to start the container again later:\n# docker start -ai sebox","tokens":[["mkdir","#A6E22E"]," ",["code","#E6DB74"],"\n",["docker","#A6E22E"]," ",["build","#E6DB74"]," ",["-t","#AE81FF"]," ",["seimage .","#E6DB74"]," ",["# build the image","#88846F"],"\n",["docker","#A6E22E"]," ",["run","#E6DB74"]," ",["-it --volume","#AE81FF"]," ",["./code:/workspace","#E6DB74"]," ",["--name","#AE81FF"]," ",["sebox seimage","#E6DB74"]," ",["# run the container using the code folder to work in","#88846F"],"\n\n",["# Run this command if you need to start the container again later:","#88846F"],"\n",["# docker start -ai sebox","#88846F"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"In another terminal on your host machine (not inside Docker), run the code below to create folders to work in for the Speakeasy and HashiCorp examples:"}],"\n",["$","$L28",null,{"codeblock":{"value":"cd code\nmkdir hashi # hashicorp\nmkdir se # speakeasy\ncd se\ntouch openapi.yaml","lang":"shellscript","meta":"","code":"cd code\nmkdir hashi # hashicorp\nmkdir se # speakeasy\ncd se\ntouch openapi.yaml","tokens":[["cd","#66D9EF"]," ",["code","#E6DB74"],"\n",["mkdir","#A6E22E"]," ",["hashi","#E6DB74"]," ",["# hashicorp","#88846F"],"\n",["mkdir","#A6E22E"]," ",["se","#E6DB74"]," ",["# speakeasy","#88846F"],"\n",["cd","#66D9EF"]," ",["se","#E6DB74"],"\n",["touch","#A6E22E"]," ",["openapi.yaml","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["You need to give your host user write permissions to files created in the container to edit them. On Unix-like systems, use the following command on your host machine, replacing ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"myusername"}]," with your user name:"]}],"\n",["$","$L28",null,{"codeblock":{"value":"sudo chown -R myusername:myusername code","lang":"txt","meta":"","code":"sudo chown -R myusername:myusername code","tokens":[["sudo chown -R myusername:myusername code","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["Now insert the Swagger Petstore example schema (available ",["$","a",null,{"href":"https://github.com/speakeasy-api/examples-repo/blob/main/how-to-build-terraform-providers/original-openapi.yaml","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":["here",[" ",["$","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"}]]}]]]}],") into the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"openapi.yaml"}]," file. The Swagger Petstore example schema is the API description of a service that manages pets and orders for pets at a store."]}],"\n",["$","h2",null,{"id":"create-a-terraform-provider-with-the-hashicorp-provider-spec-generator","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":["Create a Terraform Provider With the HashiCorp Provider Spec Generator",["$","$L26",null,{"id":"create-a-terraform-provider-with-the-hashicorp-provider-spec-generator"}]]}],"\n",["$","$L25",null,{"as":"p","children":["The ",["$","a",null,{"href":"https://developer.hashicorp.com/terraform/plugin/code-generation/design","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":["HashiCorp automated Terraform provider creator",[" ",["$","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"}]]}]]]}]," works differently from Speakeasy. HashiCorp provides an API SDK to convert your OpenAPI schema into an intermediate format, called the provider code specification (JSON). This document is then transformed into a provider by Terraform SDK. These transforming SDKs are both CLI tools."]}],"\n",["$","$L29",null,{"chart":"flowchart TD\\n subgraph 0[\" \"]\\n 1(📜 OpenAPI schema)\\n 1b(📜 Generator configuration)\\n end\\n 0 --⚙️ API SDK--> 2(📃 Provider code specification)\\n 2 --⚙️ Terraform SDK --> 3(🗝️ Go provider)"}],"\n",["$","$L25",null,{"as":"p","children":"An OpenAPI schema does not describe which Terraform resource each operation maps to. So, like Speakeasy extension attributes, you need to include mapping information in a generator configuration file along with your schema."}],"\n",["$","$L25",null,{"as":"p","children":"You can create a provider by starting at any one of the three steps:"}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","a",null,{"href":"https://developer.hashicorp.com/terraform/plugin/code-generation/openapi-generator","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":["Start with an OpenAPI schema",[" ",["$","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"}]]}]]]}],", as with Speakeasy."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":[["$","a",null,{"href":"https://developer.hashicorp.com/terraform/plugin/code-generation/framework-generator","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":["Write a provider code specification manually",[" ",["$","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"}]]}]]]}],", or with some tool the Terraform community may develop in the future, without using OpenAPI at all. Writing a provider code specification is closely coupled to the Terraform system and allows you to precisely create a compatible provider. You can even include custom Go functions to map objects between your API and Terraform. The full list of features with examples is ",["$","a",null,{"href":"https://developer.hashicorp.com/terraform/plugin/code-generation/specification","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":["here",[" ",["$","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",["$","li",null,{"className":"x:my-[.5em]","children":"Create a provider manually by coding it in Go (the traditional way)."}],"\n"]}],"\n",["$","$L25",null,{"as":"p","children":["As noted in the ",["$","a",null,{"href":"https://developer.hashicorp.com/terraform/plugin/code-generation/design#apis-support-more-than-just-terraform-providers","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":["HashiCorp code generation design principles",[" ",["$","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"}]]}]]]}],", there is a mismatch between an OpenAPI schema and a Terraform provider. Providers expect resources, transfers, and errors to relate in a way that an API doesn’t. For this reason, it’s unlikely that there will ever be a general solution to creating a provider from a schema that does not require annotations like Speakeasy extension attributes or a HashiCorp generator configuration."]}],"\n",["$","h3",null,{"id":"the-hashicorp-workflow-example","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":["The HashiCorp Workflow Example",["$","$L26",null,{"id":"the-hashicorp-workflow-example"}]]}],"\n",["$","$L25",null,{"as":"p","children":["HashiCorp provides a ",["$","a",null,{"href":"https://developer.hashicorp.com/terraform/plugin/code-generation/workflow-example","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":["full walkthrough for creating a Terraform provider from a schema",[" ",["$","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"}]]}]]]}],". The Docker container you have been working in has everything you need to follow the Hashicorp walkthrough if you’d like to. Change to the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"hashi"}]," folder and continue working."]}],"\n",["$","$L25",null,{"as":"p","children":"We don’t repeat HashiCorp’s tutorial here, but let’s take a look at the steps and how the process differs from Speakeasy."}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":["HashiCorp doesn’t create a full Go project for you. You need to create one with ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"go mod init terraform-provider-petstore"}],"."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["You need to use the framework code generator ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"scaffold"}]," command to create a template for the Go provider code, and write your own ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"main.go"}]," file."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["Instead of adding attributes to your schema, you create a ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"generator_config.yml"}]," file to hold the mapping between the schema and the provider. It looks like this:","\n",["$","$L28",null,{"codeblock":{"value":"provider:\nname: petstore\nresources:\n pet:\n create:\n path: /pet\n method: POST\n read:\n path: /pet/{petId}\n method: GET\n schema:\n attributes:\n aliases:\n petId: id","lang":"yaml","meta":"","code":"provider:\nname: petstore\nresources:\n pet:\n create:\n path: /pet\n method: POST\n read:\n path: /pet/{petId}\n method: GET\n schema:\n attributes:\n aliases:\n petId: id","tokens":[["provider","#F92672"],[":","#F8F8F2"],"\n",["name","#F92672"],[":","#F8F8F2"]," ",["petstore","#E6DB74"],"\n",["resources","#F92672"],[":","#F8F8F2"],"\n ",["pet","#F92672"],[":","#F8F8F2"],"\n ",["create","#F92672"],[":","#F8F8F2"],"\n ",["path","#F92672"],[":","#F8F8F2"]," ",["/pet","#E6DB74"],"\n ",["method","#F92672"],[":","#F8F8F2"]," ",["POST","#E6DB74"],"\n ",["read","#F92672"],[":","#F8F8F2"],"\n ",["path","#F92672"],[":","#F8F8F2"]," ",["/pet/{petId}","#E6DB74"],"\n ",["method","#F92672"],[":","#F8F8F2"]," ",["GET","#E6DB74"],"\n ",["schema","#F92672"],[":","#F8F8F2"],"\n ",["attributes","#F92672"],[":","#F8F8F2"],"\n ",["aliases","#F92672"],[":","#F8F8F2"],"\n ",["petId","#F92672"],[":","#F8F8F2"]," ",["id","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n"]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["The ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"tfplugingen-openapi generate"}]," command creates a provider code specification in JSON from your schema, and then ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"tfplugingen-framework generate"}]," creates the provider from the provider code specification, like so:","\n",["$","$L28",null,{"codeblock":{"value":"tfplugingen-openapi generate \\\n --config ./generator_config.yaml \\\n --output ./specification.json \\\n ./openapi.yaml &&\n\ntfplugingen-framework generate all \\\n --input specification.json \\\n --output internal/provider","lang":"shellscript","meta":"","code":"tfplugingen-openapi generate \\\n --config ./generator_config.yaml \\\n --output ./specification.json \\\n ./openapi.yaml &&\n\ntfplugingen-framework generate all \\\n --input specification.json \\\n --output internal/provider","tokens":[["tfplugingen-openapi","#A6E22E"]," ",["generate","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--config","#AE81FF"]," ",["./generator_config.yaml","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--output","#AE81FF"]," ",["./specification.json","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["./openapi.yaml","#E6DB74"]," ",["&&","#F8F8F2"],"\n\n",["tfplugingen-framework","#A6E22E"]," ",["generate all","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--input","#AE81FF"]," ",["specification.json","#E6DB74"]," ",["\\","#AE81FF"],"\n ",["--output","#AE81FF"]," ",["internal/provider","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n"]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["This creates the Go files ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"internal/provider/provider_petstore/petstore_provider_gen.go"}]," and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"internal/provider/resource_pet/pet_resource_gen.go"}],". The ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"_gen"}]," in the filename is a hint that a tool created the file, and it should not be edited manually."]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["The HashiCorp Terraform provider generator does not create all the code you need. It creates only the Go data types for the pet resource, not the code that manages the data. In the middle of the HashiCorp Terraform provider generation walkthrough, you can see that a long page of code needs to be copied and pasted into ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"/internal/provider/pet_resource.go"}],"."]}],"\n"]}],"\n",["$","h2",null,{"id":"create-a-terraform-provider-with-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":["Create a Terraform Provider With Speakeasy",["$","$L26",null,{"id":"create-a-terraform-provider-with-speakeasy"}]]}],"\n",["$","$L25",null,{"as":"p","children":["In the Docker container terminal, navigate to the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"se"}]," directory using the command ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"cd /workspace/se"}]," and run the following command to check that your OpenAPI schema is acceptable to Speakeasy:"]}],"\n",["$","$L28",null,{"codeblock":{"value":"speakeasy validate openapi -s openapi.yaml;","lang":"shellscript","meta":"","code":"speakeasy validate openapi -s openapi.yaml;","tokens":[["speakeasy","#A6E22E"]," ",["validate openapi","#E6DB74"]," ",["-s","#AE81FF"]," ",["openapi.yaml","#E6DB74"],[";","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["The Petstore schema has three object types: pet, order, and user. To test Terraform providers, we’ll implement the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"addPet"}]," and ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"getPetById"}]," operations. Terraform will use these two operations to create a single pet, and then check if the pet exists when verifying the Terraform state against the API. These operations correspond to Create and Read in CRUD."]}],"\n",["$","h3",null,{"id":"add-speakeasy-terraform-annotations","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":["Add Speakeasy Terraform Annotations",["$","$L26",null,{"id":"add-speakeasy-terraform-annotations"}]]}],"\n",["$","$L25",null,{"as":"p","children":"We use Speakeasy extension attributes in a schema to have Speakeasy create a Terraform provider. The Speakeasy extensions tell Terraform which OpenAPI schema operations map to which CRUD operations for each resource, and which field is the ID."}],"\n",["$","$L25",null,{"as":"p","children":["Read our ",["$","$L27",null,{"href":"/docs/create-terraform","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":"overview of how the Terraform provider creation process works"}]," or view the ",["$","$L27",null,{"href":"/docs/terraform/extensions","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":"full list of Speakeasy Terraform extensions"}]," for more information about creating Terraform providers with Speakeasy."]}],"\n",["$","$L25",null,{"as":"p","children":["Insert the following commented lines into ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"openapi.yaml"}],":"]}],"\n",["$","$L28",null,{"codeblock":{"value":"...\n post:\n tags:\n - pet\n summary: Add a new pet to the store\n description: Add a new pet to the store\n x-speakeasy-entity-operation: Pet#create # <-----\n operationId: addPet\n...\n /pet/{petId}:\n get:\n tags:\n - pet\n summary: Find pet by ID\n description: Returns a single pet\n operationId: getPetById\n x-speakeasy-entity-operation: Pet#read # <-----\n parameters:\n - name: petId\n x-speakeasy-match: id # <-----\n...\ncomponents:\n schemas:\n ...\n Pet:\n x-speakeasy-entity: Pet # <-----\n required:\n - name\n - photoUrls\n type: object\n...","lang":"yaml","meta":"","code":"...\n post:\n tags:\n - pet\n summary: Add a new pet to the store\n description: Add a new pet to the store\n x-speakeasy-entity-operation: Pet#create # <-----\n operationId: addPet\n...\n /pet/{petId}:\n get:\n tags:\n - pet\n summary: Find pet by ID\n description: Returns a single pet\n operationId: getPetById\n x-speakeasy-entity-operation: Pet#read # <-----\n parameters:\n - name: petId\n x-speakeasy-match: id # <-----\n...\ncomponents:\n schemas:\n ...\n Pet:\n x-speakeasy-entity: Pet # <-----\n required:\n - name\n - photoUrls\n type: object\n...","tokens":[["...","#F8F8F2"],"\n ",["post","#F92672"],[":","#F8F8F2"],"\n ",["tags","#F92672"],[":","#F8F8F2"],"\n ",["-","#F8F8F2"]," ",["pet","#E6DB74"],"\n ",["summary","#F92672"],[":","#F8F8F2"]," ",["Add a new pet to the store","#E6DB74"],"\n ",["description","#F92672"],[":","#F8F8F2"]," ",["Add a new pet to the store","#E6DB74"],"\n ",["x-speakeasy-entity-operation","#F92672"],[":","#F8F8F2"]," ",["Pet#create","#E6DB74"]," ",["# <-----","#88846F"],"\n ",["operationId","#F92672"],[":","#F8F8F2"]," ",["addPet","#E6DB74"],"\n",["...","#F8F8F2"],"\n ",["/pet/{petId}","#F92672"],[":","#F8F8F2"],"\n ",["get","#F92672"],[":","#F8F8F2"],"\n ",["tags","#F92672"],[":","#F8F8F2"],"\n ",["-","#F8F8F2"]," ",["pet","#E6DB74"],"\n ",["summary","#F92672"],[":","#F8F8F2"]," ",["Find pet by ID","#E6DB74"],"\n ",["description","#F92672"],[":","#F8F8F2"]," ",["Returns a single pet","#E6DB74"],"\n ",["operationId","#F92672"],[":","#F8F8F2"]," ",["getPetById","#E6DB74"],"\n ",["x-speakeasy-entity-operation","#F92672"],[":","#F8F8F2"]," ",["Pet#read","#E6DB74"]," ",["# <-----","#88846F"],"\n ",["parameters","#F92672"],[":","#F8F8F2"],"\n ",["-","#F8F8F2"]," ",["name","#F92672"],[":","#F8F8F2"]," ",["petId","#E6DB74"],"\n ",["x-speakeasy-match","#F92672"],[":","#F8F8F2"]," ",["id","#E6DB74"]," ",["# <-----","#88846F"],"\n",["...","#F8F8F2"],"\n",["components","#F92672"],[":","#F8F8F2"],"\n ",["schemas","#F92672"],[":","#F8F8F2"],"\n ",["...","#AE81FF"],"\n ",["Pet","#F92672"],[":","#F8F8F2"],"\n ",["x-speakeasy-entity","#F92672"],[":","#F8F8F2"]," ",["Pet","#E6DB74"]," ",["# <-----","#88846F"],"\n ",["required","#F92672"],[":","#F8F8F2"],"\n ",["-","#F8F8F2"]," ",["name","#E6DB74"],"\n ",["-","#F8F8F2"]," ",["photoUrls","#E6DB74"],"\n ",["type","#F92672"],[":","#F8F8F2"]," ",["object","#E6DB74"],"\n",["...","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"Validate the schema and create the provider in the Docker container:"}],"\n",["$","$L28",null,{"codeblock":{"value":"speakeasy validate openapi -s openapi.yaml &&\nspeakeasy generate sdk --schema openapi.yaml --out sdk --lang terraform","lang":"shellscript","meta":"","code":"speakeasy validate openapi -s openapi.yaml &&\nspeakeasy generate sdk --schema openapi.yaml --out sdk --lang terraform","tokens":[["speakeasy","#A6E22E"]," ",["validate openapi","#E6DB74"]," ",["-s","#AE81FF"]," ",["openapi.yaml","#E6DB74"]," ",["&&","#F8F8F2"],"\n",["speakeasy","#A6E22E"]," ",["generate sdk","#E6DB74"]," ",["--schema","#AE81FF"]," ",["openapi.yaml","#E6DB74"]," ",["--out","#AE81FF"]," ",["sdk","#E6DB74"]," ",["--lang","#AE81FF"]," ",["terraform","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["Speakeasy creates a Terraform provider (Go module) in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"sdk"}]," folder."]}],"\n",["$","h4",null,{"id":"speakeasy-security-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-xl","children":["Speakeasy Security Support",["$","$L26",null,{"id":"speakeasy-security-support"}]]}],"\n",["$","$L25",null,{"as":"p","children":["In most cases, Speakeasy should support ",["$","$L27",null,{"href":"/docs/create-terraform","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":"security in providers"}],":"]}],"\n",["$","blockquote",null,{"className":"x:not-first:mt-[1.25em] x:border-gray-300 x:italic x:text-gray-700 x:dark:border-gray-700 x:dark:text-gray-400 x:border-s-2 x:ps-[1.5em]","children":["\n",["$","$L25",null,{"as":"p","children":"Every authentication mechanism that relies on static authorization is supported with its values automatically available to be configured in the provider configuration."}],"\n"]}],"\n",["$","$L25",null,{"as":"p","children":["But you may encounter instances where this will not be true in practice. If you create a provider for the Petstore schema without removing the security elements, when you run ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"go run main.go --debug"}],", you’ll get the error:"]}],"\n",["$","$L28",null,{"codeblock":{"value":"internal/provider/pet_data_source.go:135:43: not enough arguments in call to r.client.Pet.GetPetByID\n \thave (context.Context, operations.GetPetByIDRequest)\n \twant (context.Context, operations.GetPetByIDRequest, operations.GetPetByIDSecurity)","lang":"shellscript","meta":"","code":"internal/provider/pet_data_source.go:135:43: not enough arguments in call to r.client.Pet.GetPetByID\n \thave (context.Context, operations.GetPetByIDRequest)\n \twant (context.Context, operations.GetPetByIDRequest, operations.GetPetByIDSecurity)","tokens":[["internal/provider/pet_data_source.go:135:43:","#A6E22E"]," ",["not enough arguments in call to r.client.Pet.GetPetByID","#E6DB74"],"\n \t",["have","#A6E22E"]," ",["(context.Context,","#F8F8F2"]," ",["operations.GetPetByIDRequest","#E6DB74"],[")","#F8F8F2"],"\n \t",["want","#A6E22E"]," ",["(context.Context,","#F8F8F2"]," ",["operations.GetPetByIDRequest, operations.GetPetByIDSecurity","#E6DB74"],[")","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["In this instance, Speakeasy will not create a provider, as the API method is defined to have differing ",["$","em",null,{"children":"resource"}]," security configuration to the global ",["$","em",null,{"children":"provider"}]," security configuration in the OpenAPI specification."]}],"\n",["$","$L25",null,{"as":"p","children":["Similarly, for oAuth2 authenticated APIs, the authentication mechanism between a Client and a Token endpoint is ambiguous, even in the (latest) OpenAPI 3.1 Specification. Speakeasy currently natively supports the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"client_secret_post"}]," oAuth2 authentication schema as described in Section 9 of ",["$","a",null,{"href":"https://openid.net/specs/openid-connect-discovery-1_0.html#OpenID.Core","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":["OpenID Connect Core 1.0",[" ",["$","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"}]]}]]]}],", under the client credentials flow, but does require that some code is written to help authenticate your provider with your service for your flavour of authentication."]}],"\n",["$","h3",null,{"id":"install-the-terraform-provider","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":["Install the Terraform Provider",["$","$L26",null,{"id":"install-the-terraform-provider"}]]}],"\n",["$","$L25",null,{"as":"p","children":["Run the commands below in the Docker terminal to install the Terraform provider as ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"root/go/bin/terraform-provider-terraform"}],":"]}],"\n",["$","$L28",null,{"codeblock":{"value":"cd sdk\ngo install","lang":"shellscript","meta":"","code":"cd sdk\ngo install","tokens":[["cd","#66D9EF"]," ",["sdk","#E6DB74"],"\n",["go","#A6E22E"]," ",["install","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["You need to edit the Terraform settings file to redirect provider requests from the online Terraform repository to the custom local provider we created, or Terraform will try to find a provider online for your service and fail. The file is not in the shared ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"code"}]," folder, so you need to edit it in the Docker terminal. Below we use Vim."]}],"\n",["$","$L28",null,{"codeblock":{"value":"vim /root/.terraformrc\n\n# inside vim:\n# i to enter into edit mode\n# ctrl-shift-v to paste the text below:\n\nprovider_installation {\n dev_overrides {\n \"speakeasy/terraform\" = \"/root/go/bin\",\n \"terraform-provider-petstore\" = \"/root/go/bin\"\n }\n direct {}\n}\n\n# escape to exit edit mode\n# :wq to write and quit vim","lang":"shellscript","meta":"","code":"vim /root/.terraformrc\n\n# inside vim:\n# i to enter into edit mode\n# ctrl-shift-v to paste the text below:\n\nprovider_installation {\n dev_overrides {\n \"speakeasy/terraform\" = \"/root/go/bin\",\n \"terraform-provider-petstore\" = \"/root/go/bin\"\n }\n direct {}\n}\n\n# escape to exit edit mode\n# :wq to write and quit vim","tokens":[["vim","#A6E22E"]," ",["/root/.terraformrc","#E6DB74"],"\n\n",["# inside vim:","#88846F"],"\n",["# i to enter into edit mode","#88846F"],"\n",["# ctrl-shift-v to paste the text below:","#88846F"],"\n\n",["provider_installation","#A6E22E"]," ",["{","#E6DB74"],"\n ",["dev_overrides","#A6E22E"]," ",["{","#E6DB74"],"\n ",["\"speakeasy/terraform\"","#A6E22E"]," ",["= \"/root/go/bin\",","#E6DB74"],"\n ",["\"terraform-provider-petstore\"","#A6E22E"]," ",["= \"/root/go/bin\"","#E6DB74"],"\n ",["}","#F8F8F2"],"\n ",["direct","#A6E22E"]," ",["{}","#E6DB74"],"\n",["}","#F8F8F2"],"\n\n",["# escape to exit edit mode","#88846F"],"\n",["# :wq to write and quit vim","#88846F"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["Here we add ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"terraform-provider-petstore"}]," in addition to the Speakeasy line so that your container is ready to run the HashiCorp tutorial later."]}],"\n",["$","h3",null,{"id":"call-the-provider-from-terraform","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":["Call the Provider From Terraform",["$","$L26",null,{"id":"call-the-provider-from-terraform"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Now that the provider is installed and ready, we need a Terraform resource configuration file as input."}],"\n",["$","$L25",null,{"as":"p","children":["Insert the code from ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"sdk/examples/provider/provider.tf"}]," (which defines the provider to use) into ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"sdk/examples/resources/terraform_pet/resource.tf"}]," (which defines the resource to change). The final ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"sdk/examples/resources/terraform_pet/resource.tf"}]," file should look like this:"]}],"\n",["$","$L28",null,{"codeblock":{"value":"terraform {\n required_providers {\n terraform = {\n source = \"speakeasy/terraform\"\n version = \"0.0.1\"\n }\n }\n}\n\nprovider \"terraform\" {\n # Configuration options\n}\n\nresource \"terraform_pet\" \"my_pet\" {\n id = 10\n name = \"doggie\"\n photo_urls = [\n \"...\",\n ]\n status = \"available\"\n}","lang":"hcl","meta":"","code":"terraform {\n required_providers {\n terraform = {\n source = \"speakeasy/terraform\"\n version = \"0.0.1\"\n }\n }\n}\n\nprovider \"terraform\" {\n # Configuration options\n}\n\nresource \"terraform_pet\" \"my_pet\" {\n id = 10\n name = \"doggie\"\n photo_urls = [\n \"...\",\n ]\n status = \"available\"\n}","tokens":[["terraform","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["required_providers","#A6E22E",{"textDecoration":"underline"}]," ",["{","#F8F8F2"],"\n ",["terraform","#F8F8F2"]," ",["=","#F92672"]," ",["{","#F8F8F2"],"\n ",["source","#F8F8F2"]," ",["=","#F92672"]," ",["\"speakeasy/terraform\"","#E6DB74"],"\n ",["version","#F8F8F2"]," ",["=","#F92672"]," ",["\"0.0.1\"","#E6DB74"],"\n ",["}","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n",["}","#F8F8F2"],"\n\n",["provider","#A6E22E",{"textDecoration":"underline"}]," ",["\"terraform\" {","#F8F8F2"],"\n ",["# Configuration options","#88846F"],"\n",["}","#F8F8F2"],"\n\n",["resource","#A6E22E",{"textDecoration":"underline"}]," ",["\"terraform_pet\" \"my_pet\" {","#F8F8F2"],"\n ",["id","#F8F8F2"]," ",["=","#F92672"]," ",["10","#AE81FF"],"\n ",["name","#F8F8F2"]," ",["=","#F92672"]," ",["\"doggie\"","#E6DB74"],"\n ",["photo_urls","#F8F8F2"]," ",["=","#F92672"]," ",["[","#F8F8F2"],"\n ",["\"...\"","#E6DB74"],[",","#F8F8F2"],"\n ",["]","#F8F8F2"],"\n ",["status","#F8F8F2"]," ",["=","#F92672"]," ",["\"available\"","#E6DB74"],"\n",["}","#F8F8F2"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"Now we can call the Petstore service through the API using Terraform and the resource configuration file. In Docker:"}],"\n",["$","$L28",null,{"codeblock":{"value":"cd /workspace/se/sdk/examples/resources/terraform_pet\nterraform plan\nterraform apply","lang":"shellscript","meta":"","code":"cd /workspace/se/sdk/examples/resources/terraform_pet\nterraform plan\nterraform apply","tokens":[["cd","#66D9EF"]," ",["/workspace/se/sdk/examples/resources/terraform_pet","#E6DB74"],"\n",["terraform","#A6E22E"]," ",["plan","#E6DB74"],"\n",["terraform","#A6E22E"]," ",["apply","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":"The result is an expected Terraform execution:"}],"\n",["$","$L28",null,{"codeblock":{"value":"$2a","lang":"shellscript","meta":"","code":"$2b","tokens":[["/workspace/se/sdk/examples/resources/terraform_pet","#A6E22E"]," ",["# terraform apply","#88846F"],"\n",["╷","#A6E22E"],"\n",["│","#A6E22E"]," ",["Warning: Provider development overrides are in effect","#E6DB74"],"\n",["│","#A6E22E"],"\n",["│","#A6E22E"]," ",["The following provider development overrides are set in the CLI configuration:","#E6DB74"],"\n",["│","#A6E22E"]," ",["- speakeasy/terraform in /root/go/bin","#E6DB74"],"\n",["│","#A6E22E"]," ",["- speakeasy/hashicups in /root/go/bin","#E6DB74"],"\n",["│","#A6E22E"],"\n",["│","#A6E22E"]," ",["The behavior may therefore not match any released version of the provider and applying changes may cause the state to become incompatible with published releases.","#E6DB74"],"\n",["╵","#A6E22E"],"\n\n",["Terraform","#A6E22E"]," ",["used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols:","#E6DB74"],"\n ",["+","#A6E22E"]," ",["create","#E6DB74"],"\n\n",["Terraform","#A6E22E"]," ",["will perform the following actions:","#E6DB74"],"\n\n ",["# terraform_pet.my_pet will be created","#88846F"],"\n ",["+","#A6E22E"]," ",["resource \"terraform_pet\" \"my_pet\" {","#E6DB74"],"\n ",["+","#A6E22E"]," ",["category =","#E6DB74"]," ",["(known","#F8F8F2"]," ",["after apply","#E6DB74"],[")","#F8F8F2"],"\n ",["+","#A6E22E"]," ",["id =","#E6DB74"]," ",["10","#AE81FF"],"\n ",["+","#A6E22E"]," ",["name = \"doggie\"","#E6DB74"],"\n ",["+","#A6E22E"]," ",["photo_urls =","#E6DB74"]," ",["[","#F8F8F2"],"\n ",["+","#A6E22E"]," ",["\"...\",","#E6DB74"],"\n ",["]","#F8F8F2"],"\n ",["+","#A6E22E"]," ",["status = \"available\"","#E6DB74"],"\n ",["+","#A6E22E"]," ",["tags =","#E6DB74"]," ",["(known","#F8F8F2"]," ",["after apply","#E6DB74"],[")","#F8F8F2"],"\n ",["}","#F8F8F2"],"\n\n",["Plan:","#A6E22E"]," ",["1","#AE81FF"]," ",["to add,","#E6DB74"]," ",["0","#AE81FF"]," ",["to change,","#E6DB74"]," ",["0","#AE81FF"]," ",["to destroy.","#E6DB74"],"\n\n",["Do","#A6E22E"]," ",["you want to perform these actions?","#E6DB74"],"\n ",["Terraform","#A6E22E"]," ",["will perform the actions described above.","#E6DB74"],"\n ",["Only","#A6E22E"]," ",["'yes' will be accepted to approve.","#E6DB74"],"\n\n ",["Enter","#A6E22E"]," ",["a value: yes","#E6DB74"],"\n\n",["terraform_pet.my_pet:","#A6E22E"]," ",["Creating...","#E6DB74"],"\n",["terraform_pet.my_pet:","#A6E22E"]," ",["Creation complete after 2s","#E6DB74"]," ",["[name=doggie]","#F8F8F2"],"\n\n",["Apply","#A6E22E"]," ",["complete! Resources:","#E6DB74"]," ",["1","#AE81FF"]," ",["added,","#E6DB74"]," ",["0","#AE81FF"]," ",["changed,","#E6DB74"]," ",["0","#AE81FF"]," ",["destroyed.","#E6DB74"]],"annotations":[],"themeName":"monokai","style":{"color":"#F8F8F2","background":"#272822","colorScheme":"dark"}}}],"\n",["$","$L25",null,{"as":"p","children":["You’ll notice we do not have a local implementation of the API service running somewhere for the provider to call. The Petstore example is a real service provided online by Swagger. You can see the URL in the ",["$","code",null,{"className":"nextra-code","dir":"ltr","children":"server"}]," field of the schema. For example, you can browse to an operation at ",["$","a",null,{"href":"https://petstore3.swagger.io/","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":["https://petstore3.swagger.io/",[" ",["$","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":"If you are building your own API, you’ll need to make a service the provider can call."}],"\n",["$","h3",null,{"id":"summary-of-the-speakeasy-terraform-provider-creation-process","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":["Summary of the Speakeasy Terraform Provider Creation Process",["$","$L26",null,{"id":"summary-of-the-speakeasy-terraform-provider-creation-process"}]]}],"\n",["$","$L25",null,{"as":"p","children":"Let’s review what we did:"}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":"Annotate an OpenAPI schema file with Speakeasy extension attributes to indicate which operations are for which Terraform CRUD functions."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Remove security elements and non-JSON request and response elements."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Create the Terraform provider Go code with Speakeasy."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Compile and install the provider."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Redirect Terraform settings to use the local provider."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Make a Terraform resource configuration file."}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":"Run Terraform against the file."}],"\n"]}],"\n",["$","$L25",null,{"as":"p","children":"As your API changes over time and you release new Terraform provider versions to clients, you will need to add extension attributes. Apart from that, the Terraform provider creation process should be an automated set of terminal commands."}],"\n",["$","h2",null,{"id":"comparison-and-conclusion","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":["Comparison and Conclusion",["$","$L26",null,{"id":"comparison-and-conclusion"}]]}],"\n",["$","$L25",null,{"as":"p","children":"In conclusion, Speakeasy provides a complete solution for creating a Terraform provider from a schema with only one manual step. The HashiCorp automated Terraform provider generator is not ready for production use yet, but is something to keep an eye on during 2024 to see how it catches up. The HashiCorp provider code specification intermediate language will also benefit from the massive Terraform community building plugins."}],"\n",["$","$L25",null,{"as":"p","children":["Read ",["$","$L27",null,{"href":"/customers/airbyte","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":"our case study on how leading data integration platform Airbyte uses Speakeasy"}]," to create and maintain Terraform providers alongside SDKs and minimize engineer burden."]}],"\n",["$","h2",null,{"id":"further-reading","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":["Further Reading",["$","$L26",null,{"id":"further-reading"}]]}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":["$","$L27",null,{"href":"/post/build-terraform-providers","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":"Benefits of providers for an API"}]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["$","a",null,{"href":"https://github.com/speakeasy-api/examples-repo/blob/main/how-to-build-terraform-providers/original-openapi.yaml","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":["Original Petstore example",[" ",["$","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",["$","li",null,{"className":"x:my-[.5em]","children":["$","a",null,{"href":"https://github.com/speakeasy-api/examples-repo/blob/main/how-to-build-terraform-providers/annotated-openapi.yaml","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":["Annotated Petstore example",[" ",["$","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",["$","li",null,{"className":"x:my-[.5em]","children":["$","a",null,{"href":"https://github.com/hashicorp/terraform-provider-hashicups","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":["HashiCorp provider example",[" ",["$","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",["$","li",null,{"className":"x:my-[.5em]","children":["$","a",null,{"href":"https://github.com/speakeasy-sdks/terraform-provider-hashicups","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 provider example",[" ",["$","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",["$","li",null,{"className":"x:my-[.5em]","children":["$","a",null,{"href":"https://opentofu.org","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":["OpenTofu — the open-source Terraform substitute",[" ",["$","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"]}],"\n",["$","h3",null,{"id":"hashicorp-automated-terraform-provider-creation","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":["HashiCorp Automated Terraform Provider Creation",["$","$L26",null,{"id":"hashicorp-automated-terraform-provider-creation"}]]}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":["$","a",null,{"href":"https://developer.hashicorp.com/terraform/plugin/code-generation/design","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 overview",[" ",["$","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",["$","li",null,{"className":"x:my-[.5em]","children":["$","a",null,{"href":"https://developer.hashicorp.com/terraform/plugin/code-generation/specification","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":["Provider code specification 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",["$","li",null,{"className":"x:my-[.5em]","children":["$","a",null,{"href":"https://github.com/hashicorp/terraform-plugin-codegen-openapi","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":["OpenAPI schema 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",["$","li",null,{"className":"x:my-[.5em]","children":["$","a",null,{"href":"https://github.com/hashicorp/terraform-plugin-codegen-framework","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":["Terraform 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"]}],"\n",["$","h3",null,{"id":"speakeasy-automated-terraform-provider-creation","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 Automated Terraform Provider Creation",["$","$L26",null,{"id":"speakeasy-automated-terraform-provider-creation"}]]}],"\n",["$","ul",null,{"className":"list-disc [&>li]:mt-2 [&>li]:ml-4","children":["\n",["$","li",null,{"className":"x:my-[.5em]","children":["$","$L27",null,{"href":"/docs/create-terraform","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":"Documentation overview"}]}],"\n",["$","li",null,{"className":"x:my-[.5em]","children":["$","$L27",null,{"href":"/docs/terraform/extensions","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":"Annotation documentation"}]}],"\n"]}]]]}]]}]]}]}],false]