The v1.5.4-rc1 release is an experimental release candidate that introduces support for the ListUsers API. This endpoint answers the question "what users have relation X with object Y?". This can be used for use cases like share dialogues and notifying users on document changes.
This API can be enabled in the server by passing the --experimentals enable-list-users flag. Also note the OPENFGA_LIST_USERS_MAX_RESULTS, OPENFGA_LIST_USERS_DEADLINE and OPENFGA_MAX_CONCURRENT_READS_FOR_LIST_USERS configuration options.
Note: This is not ready for production use. Currently outstanding issues:
- Excluded users are not supported, which impacts models that pair wildcards (e.g.
user:*) with exclusion (e.g.but not) - Chaining multiple exclusion (e.g.
but not) operands may not return accurate set of results
Related resources: