Question about API filter behavior: Are query filters cumulative?

[Prometee]

Hello,

I'm working with the Keygen API and have a question about how query filters behave when multiple filters are applied to the same endpoint.

The Issue

While using the Users endpoint, I discovered that certain filters appear to be mutually exclusive. Specifically:

• I cannot use status (or roles) and metadata filters simultaneously
• When I attempt to combine these filters, only one appears to be applied

Example

For instance, when trying to filter users by both status and metadata:

GET /v1/accounts/{account}/users?status=ACTIVE&metadata[key]=value

It seems only one filter is respected, rather than both being applied cumulatively.

Questions

1. Is this the intended behavior? Are certain filters designed to be mutually exclusive?
2. Is this documented? I've reviewed the API documentation but couldn't find any mention of filter compatibility or limitations when combining multiple filters.
3. What's the recommended approach? If filters cannot be combined, what's the best practice for achieving filtered results that would require multiple criteria?

Any clarification on how filters interact with each other across different endpoints would be greatly appreciated!

Thanks in advance for your help.

[ezekg]

Filters can be combined, including metadata. This is likely user error. If you're using curl, this could be because you're 1) not using the -g flag to support brackets i.e. [], or 2) not quoting the URL string (the & query param separator is a special Shell keyword for background tasks). You may also be providing the metadata incorrectly, e.g. improper query param encoding, etc.

curl -vg -u token:$KEYGEN_TOKEN 'https://api.keygen.sh/v1/accounts/demo/users?status=active&metadata[foo]=bar'

This should work fine. If not, please provide a link to a request log of this occurring and I'll reopen.