René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Request bodies with `required: false` should have an optional argument for body","articleBody":"For instance, given:\n\n```yaml\nopenapi: \"3.0.0\"\ninfo:\n  version: 1.0.0\n  title: Generate models\npaths:\n  /client:\n    put:\n      operationId: updateClient\n      requestBody:\n        required: false\n        content:\n          application/json:\n            schema:\n              type: object\n              properties:\n                foo:\n                  type: string\n\n```\n`oapi-codegen` v2.5.0 will generate:\n\n```go\npackage client\n\n// ...\n\ntype UpdateClientJSONBody struct {\n\tFoo *string `json:\"foo,omitempty\"`\n}\n\n// NOTE that this is not optional\ntype UpdateClientJSONRequestBody UpdateClientJSONBody\n\ntype ClientInterface interface {\n    // NOTE that this is not an optional body\n\tUpdateClientWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)\n\n    // NOTE that this is not an optional body\n\tUpdateClient(ctx context.Context, body UpdateClientJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)\n}\n```\n\nIt would be better if we detected `required: false` and instead i.e.\n\n```go\ntype UpdateClientJSONRequestBody *UpdateClientJSONBody\n\ntype ClientInterface interface {\n    // A body can be set from raw data\n\tUpdateClientWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)\n\n    // A body can be set as its struct\n\tUpdateClient(ctx context.Context, body *UpdateClientJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)\n}\n```\n\nAs a breaking change to currently generated code, this would be via an `output-options`.\n","author":{"url":"https://github.com/jamietanna","@type":"Person","name":"jamietanna"},"datePublished":"2026-02-02T10:33:30Z","url":"https://github.com/oapi-codegen/oapi-codegen/issues/2194"}