Need complete documentation for connector "Power Apps for Makers"

The documentation here on the connector is terse for my purposes and needs.

I have run into an issue where parameters are REQUIRED but documented as optional thuse causing a blocker.

Example: click here Operation ID:Get-Connectors

Says parameter (Filter Query $filter) is optional, but it is not in fact it's required and if you try running it without the parameter you get...
- PowerAppsforMakers.GetConnectors failed: {"error": {"code": "MissingEnvironmentFilter", "message": "The environment filter must be set."}}

This is a major blocker because Intellisense in make.powerapps.com does not help to discover all the internal parameters of $filter, nor does it clearly state this is an ODATA filter similar to power automate. I was after a long time able to figure out the internal parameter name for filter is simply "environment" and that the value is the GUID not the displayName. It was pure LUCK I stumbled across this blogpost, and applied it to my code for another action in the same connector.

ClearCollect(MyAppConnectors,PowerAppsforMakers.GetConnectors({'$filter':"environment eq '"& Dropdown2.SelectedText.Env &"' "}).value)

This got me past the error but I am still blocked...

@microsoft/ @PowerCat more context and information is needed for this connector.

What are all the usable internal parameters of $filter
What is the context or scope for for the action "Get Connectors"
- Environment
- for a chosen app (The context that I want to use it for, see attached sample app)

The above mentioned documentation page suffers from MISSING examples for EACH of the actions.

Because I cannot waste any more time dealing with this, I've surrendered to making this post as a last resort.

Categories:

Connectors

Using Apps Using Formulas