Skip to content

Commit 9141ce8

Browse files
committed
Sync open source content 🐝 (from 3630ea3d4506e7f0335d36235f3c111f87c64711)
1 parent 82624d3 commit 9141ce8

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

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

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -187,3 +187,16 @@ Controls how `allOf` constructs in OpenAPI schemas are merged. For detailed info
187187
schemas:
188188
allOfMergeStrategy: deepMerge
189189
```
190+
191+
### multipartArrayFormat
192+
193+
Controls how arrays are serialized in multipart/form-data requests. This option determines whether array field names include brackets (`[]`) or use the RFC 7578-compliant approach of repeating the same field name.
194+
195+
- `legacy` (default for existing SDKs): Appends `[]` to array field names (e.g., `files[]`). This maintains backward compatibility with existing SDKs but is non-compliant with RFC 7578.
196+
- `standard` (default for new SDKs): Uses the RFC 7578-compliant format by repeating the same field name for each array element (e.g., multiple `files` fields). This is the correct multipart/form-data encoding according to RFC 7578 Section 4.3.
197+
198+
```yaml
199+
multipartArrayFormat: standard
200+
```
201+
202+
**Migration note**: Changing from `legacy` to `standard` is a breaking change. APIs expecting field names with `[]` suffixes will need to be updated to handle the RFC-compliant format.

0 commit comments

Comments
 (0)