Sync open source content 🐝 (from 94e1c29afb509d5abbd809501a75b3ad2334742d)

Author: beezythebot

docs/terraform/customize/property-customization.mdx

@@ -153,6 +153,27 @@ components:
           x-speakeasy-param-sensitive: true
 ```
 
+## Write only
+
+Mark a schema attribute as a [write only argument](https://developer.hashicorp.com/terraform/plugin/framework/resources/write-only-arguments) (`WriteOnly: true` in the schema definition) with the `x-speakeasy-terraform-write-only` extension. Write only functionality prevents values from ever being exposed in plan or state data as a more complete secret value solution over sensitive attributes.
+
+<Callout title="Warning" type="warning">
+  Write only functionality is only supported in Terraform/OpenTofu 1.11 and later. Using it on earlier versions of Terraform/OpenTofu will result in a configuration error.
+</Callout>
+
+```yaml
+components:
+  schemas:
+    Pet:
+      type: object
+      properties:
+        name:
+          type: string
+        secret:
+          type: string
+          x-speakeasy-terraform-write-only: true
+```
+
 ## Deprecation
 
 Add OAS `deprecated: true` within a property to automatically return a warning diagnostic with a generic deprecation message when the property is configured in Terraform. Customize the messaging with the OAS `x-speakeasy-deprecation-message` extension.