.Net: Python: Bug: OpenAPI plugin sends array and boolean query parameters as Python repr (tags=['a', 'b'], active=True)

Open
#14,788 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 3 days

@jeevan1098 is already working on this.

Since Nov 12, 2026.

  • #14789 by @jeevan1098 — open
  • #14800 by @DYNOSuprovo — open

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
35/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Stale
Tech stack
openapi, python
Domain
api

Research direction

Start with python/semantic_kernel/connectors/openapi_plugin/models/rest_api_operation.py, especially the query, header, and path parameter handling cited in the issue, and check how the .NET OpenAPI plugin serializes arrays. Use the offline httpx.MockTransport reproduction to inspect the captured URL. Done means array query values use repeated keys and booleans are lowercase; account for the linked open pull request before starting.

Written by the indexing model from the issue text.

Description

.NET python triage

Describe the bug

The OpenAPI plugin builds the query string with urlencode(segments) and passes argument values through unchanged:

https://github.com/microsoft/semantic-kernel/blob/25bd1bb67c38976bb13958783572efa57d3445d4/python/semantic_kernel/connectors/openapi_plugin/models/rest_api_operation.py#L386-L400

Without doseq=True, urlencode calls str() on each value. So an array query parameter is sent as Python's list repr (['red', 'blue']), and a boolean is sent as True/False. APIs can't parse either. OpenAPI's default for query parameters is style: form, explode: true, which means tags=red&tags=blue and active=true. The .NET OpenAPI plugin already serializes arrays this way.

The schema advertised to the model says {"type": "array", "items": {"type": "string"}}, so a tool call from the model hits this.

Header and path parameters have the same problem, since they use str(argument) (L218, L331).

To Reproduce

semantic-kernel 1.47.0. rest_api_operation.py is the same on main (25bd1bb6). This runs offline: httpx.MockTransport captures the request, and the server is an IP literal so the URL validator doesn't need DNS.

import asyncio, httpx
from semantic_kernel import Kernel
from semantic_kernel.connectors.openapi_plugin import OpenAPIFunctionExecutionParameters

spec = {
    "openapi": "3.0.1", "info": {"title": "t", "version": "1"},
    "servers": [{"url": "https://93.184.216.34"}],
    "paths": {"/items": {"get": {
        "operationId": "listItems",
        "parameters": [
            {"name": "tags", "in": "query", "schema": {"type": "array", "items": {"type": "string"}}},
            {"name": "active", "in": "query", "schema": {"type": "boolean"}},
        ],
        "responses": {"200": {"description": "ok"}},
    }}},
}

seen = []
def handler(request):
    seen.append(str(request.url))
    return httpx.Response(200, json={})

async def main():
    client = httpx.AsyncClient(transport=httpx.MockTransport(handler))
    kernel = Kernel()
    plugin = kernel.add_plugin_from_openapi(
        "api", openapi_parsed_spec=spec,
        execution_settings=OpenAPIFunctionExecutionParameters(http_client=client),
    )
    await kernel.invoke(plugin["listItems"], tags=["red", "blue"], active=True)
    print(seen[0])

asyncio.run(main())

Output:

https://93.184.216.34/items?tags=%5B%27red%27%2C+%27blue%27%5D&active=True

Expected behavior

https://93.184.216.34/items?tags=red&tags=blue&active=true

(form/explode, the OpenAPI default for query parameters), with booleans written as JSON true/false.

Platform

  • Language: Python
  • Source: semantic-kernel 1.47.0 (pip) / main at 25bd1bb6
  • AI model: n/a (no model call needed)
  • IDE: n/a
  • OS: Windows 11, Python 3.12

Additional context

The parser doesn't read style/explode from the spec yet (RestApiParameter is always built without them), so the smallest fix is to serialize lists as repeated keys (doseq=True) and booleans as lowercase. Happy to send a fix if that helps.

Dominant language
C#
Stars
28.8k
Forks
4.9k
Avg merge
2d 17h
Merged PRs (30d)
48

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from microsoft/semantic-kernel

All issues in microsoft/semantic-kernel

Similar issues

More C# issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.