Sync open source content 🐝 (from 600699749ca5d08d5d8f5a66c8470c477ae11ec8)

Author: beezythebot

docs/sdks/sdk-contract-testing/bootstrapping-test-generation.mdx

@@ -48,12 +48,15 @@ generation:
   tests:
     generateTests: true # Controls whether tests are generated during speakeasy run
     generateNewTests: true # Controls whether new tests are added for new operations
+    skipResponseBodyAssertions: false # Controls whether response body assertions are included in generated tests
 ```
 
 The `generateTests` setting controls whether test generation is enabled when running [`speakeasy run`](/docs/speakeasy-reference/cli/run). When set to `true`, tests defined in the `.speakeasy/tests.arazzo.yaml` document will be generated. When set to `false`, tests won't be generated.
 
 The `generateNewTests` setting controls whether new tests are automatically added to the `.speakeasy/tests.arazzo.yaml` document when new operations are found in the OpenAPI specification.
 
+The `skipResponseBodyAssertions` setting controls whether generated tests include response body assertions. When set to `true`, generated tests omit all response body assertions while still asserting on status codes. This is useful when API response bodies are non-deterministic (e.g., dynamic data, timestamps, random IDs) or when using a test server or mock that doesn't return realistic response payloads. Defaults to `false`. This setting applies globally to all generated tests for the target with no per-operation override.
+
 When enabling for the first time this will generate tests for all operations in the OpenAPI document.
 Then going forward it will only generate tests for any operations not already found in the `.speakeasy/tests.arazzo.yaml` file.
 

docs/sdks/sdk-contract-testing/customizing-sdk-tests.mdx

@@ -115,6 +115,24 @@ workflows:
 Directly modifying SDK tests is not common, but it is possible to customize the actual content of an existing SDK test by modifying the `.speakeasy/tests.arazzo.yaml` file.
 To learn more about these kinds of modifications see [here](/docs/sdk-testing/api-contract-tests#writing-custom-end-to-end-tests).
 
+## Skip response body assertions
+
+To omit all response body assertions from generated tests, set the `skipResponseBodyAssertions` option to `true` in the `generation.tests` section of the [`.speakeasy/gen.yaml`](/docs/speakeasy-reference/generation/gen-yaml) file:
+
+```yaml
+generation:
+  tests:
+    skipResponseBodyAssertions: true
+```
+
+When enabled, generated tests still assert on status codes but do not assert on the shape or values of the response body. This is useful when:
+
+- API response bodies are non-deterministic (e.g., dynamic data, timestamps, random IDs)
+- A test server or mock doesn't return realistic response payloads
+- SDK calls need to be verified as successful without brittle assertions on exact response content
+
+This setting applies globally to all generated tests for the target. There is no per-operation override.
+
 ## Next Steps
 
 - [Setup testing in GitHub Actions](/docs/sdk-testing/github-actions)

docs/speakeasy-reference/generation/gen-yaml.mdx

@@ -185,6 +185,21 @@ Changes the field name of the request body parameter from using a flattened requ
   requestBodyFieldName: body
 ```
 
+### tests
+
+Configuration for SDK test generation. For more information about SDK testing, see the [SDK contract testing documentation](/docs/sdk-testing/bootstrapping-test-generation).
+
+- `generateTests`: Controls whether tests are generated during [`speakeasy run`](/docs/speakeasy-reference/cli/run). Defaults to `false`.
+- `generateNewTests`: Controls whether new tests are automatically added for newly discovered operations. Defaults to `false`.
+- `skipResponseBodyAssertions`: When `true`, generated tests omit all response body assertions while still asserting on status codes. Useful when API response bodies are non-deterministic (e.g., dynamic data, timestamps, random IDs) or when using a test server or mock that doesn't return realistic response payloads. Defaults to `false`. Applies globally to all generated tests for the target with no per-operation override.
+
+```yaml
+  tests:
+    generateTests: true
+    generateNewTests: true
+    skipResponseBodyAssertions: false
+```
+
 ### mockServer
 
 Disables the generation and use of a mock HTTP server with generated tests.