You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/speakeasy-reference/generation/gen-yaml.mdx
+13Lines changed: 13 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -187,3 +187,16 @@ Controls how `allOf` constructs in OpenAPI schemas are merged. For detailed info
187
187
schemas:
188
188
allOfMergeStrategy: deepMerge
189
189
```
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