Dashboard sharing with users and organisations returns inconsistent values

[emcmd]

The API for sharing dashboards with users/orgs returns different results depending on whether the dashboard was previously shared/not shared with the users/orgs. This should at least be clarified in the documentation.

This is observed both in PyLana and the API directly.

[mmzx]

Please let us know if you need clarification about the implemented behaviour. I would be a good candidate for such a clarification on slack, for e.g. :)

In principle:
Any sharing relates to either user or organization, not both at the same time.
In case of organization, that's an additive operation over multiple requests.
In case of user-to-user sharing, every time a request is received in the list of users to share the resource (e.g. dashboard) with the already existing state (if any) of user-to-user is cleared and the list which has been received last would prevail. So, user-to-user sharing is not an additive operation.
There is also the swagger documentation which - I believe - helps explaining it. Though, very briefly.

[emcmd]

Ok, I'll adjust and clarify the behaviour of the respective PyLana calls.