> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/adapters/configure/add-query-parameters/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Add query parameters

> How to pass dynamic query parameters to an adapter call using the iapMetadata object, without requiring a code change.

Adding query parameters to an adapter call previously required a code change, because query parameters were not exposed as method parameters. Adding them was treated as a breaking change, so the Adapter Team would add a new call instead.

With `iapMetadata`, no new call or code change is required.

## Pass query parameters via iapMetadata

If the adapter method has an `iapMetadata` parameter, pass query parameters inside a `uriQuery` object on that parameter. You can construct the `iapMetadata` object usingItential Platform workflow capabilities such as `query` and `merge`.

Structure:

```json
{
  "uriQuery": {
    "<key1>": "<value1>"
  }
}
```

Example:

```json
{
  "uriQuery": {
    "size": 20,
    "offset": 60
  }
}
```

If the adapter method does not have an `iapMetadata` parameter, you can request that the Adapter Team add it. Note that adding `iapMetadata` requires creating new methods — Itential does not modify existing method signatures to avoid breaking changes.

> How to pass dynamic query parameters to an adapter call using the iapMetadata object, without requiring a code change.