Skip to content

Add support for exploded query params#1002

Open
Ivan-Roger wants to merge 1 commit intodanielgtaylor:mainfrom
Ivan-Roger:feat/explode-query-params
Open

Add support for exploded query params#1002
Ivan-Roger wants to merge 1 commit intodanielgtaylor:mainfrom
Ivan-Roger:feat/explode-query-params

Conversation

@Ivan-Roger
Copy link
Copy Markdown

@Ivan-Roger Ivan-Roger commented Mar 25, 2026

This allows for free-form query params in the case where they cannot be described in the openapi docs.
They will be stored as a map of strings (keys) to list of strings (values).

Example:

URI: /search?name=foo&status=active

{
    "/search": {
        "get": {
            "summary": "Search items",
            "description": "Search items",
            "operationId": "search",
            "parameters": [
                {
                    "explode": true,
                    "in": "query",
                    "name": "filters",
                    "schema": {
                        "additionalProperties": {
                            "items": {
                                "type": "string"
                            },
                            "type": [
                                "array",
                                "null"
                            ]
                        },
                        "type": "object"
                    }
                }
            ]
        }
    }
}

@Ivan-Roger Ivan-Roger force-pushed the feat/explode-query-params branch 3 times, most recently from 8bdb389 to bce7660 Compare March 25, 2026 15:07
@Ivan-Roger Ivan-Roger force-pushed the feat/explode-query-params branch from bce7660 to 1ffd554 Compare March 25, 2026 15:08
@wolveix
Copy link
Copy Markdown
Collaborator

wolveix commented Mar 25, 2026

Hey @Ivan-Roger, could you give an example of what issue this is resolving? A complete code sample always helps cut down on the time necessary to review PRs :)

@Ivan-Roger
Copy link
Copy Markdown
Author

Hey,
Sorry. I openned the PR in a hurry. I added a description.
I'm available if you need any clarifications

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants