chore: list users announcement (#731)

blog/authors.yml

@@ -6,4 +6,8 @@ aaguiar:
 eharris:
   name: Ewan Harris
   url: https://github.com/ewanharris
-  image_url: /img/blog/authors/ewan.jpg
+  image_url: /img/blog/authors/ewan.jpg
+miparnisari:
+  name: Maria Ines Parnisari
+  url: https://github.com/miparnisari
+  image_url: /img/blog/authors/miparnisari.jpg

blog/list-users-announcement.md

@@ -0,0 +1,45 @@
+---
+title: List Users API
+description: List Users API 
+slug: list-users-announcement
+date: 2024-04-30
+authors: miparnisari
+tags: [openfga,features]
+image: https://openfga.dev/img/og-rich-embed.png
+hide_table_of_contents: false
+---
+# New ListUsers API on OpenFGA
+
+Today we are launching a new API for OpenFGA: ListUsers.
+
+This API will answer the question "what users have relation X with object Y?". This will be useful, for example, in UIs that want to display the list of users that a resource has been shared with, e.g. the "share" dialog in Google Docs.
+
+You can read more about this API [here](https://openfga.dev/api/service#/Relationship%20Queries/ListUsers).
+
+## How to use it?
+
+ListUsers is available in the latest Release Candidate version of OpenFGA: [v1.5.4-rc1](https://github.com/openfga/openfga/releases/tag/v1.5.4-rc1).
+
+To be able to call this API, you must turn on this flag on the server: `--experimentals enable-list-users`. Be sure to also check out the various configuration flags that were added to control its behavior.
+
+You can also call this API via the SDKs:
+- [Java v0.4.2](https://github.com/openfga/java-sdk/releases/tag/v0.4.2)
+- [.NET v0.3.2](https://github.com/openfga/dotnet-sdk/releases/tag/v0.3.2)
+- [Go v0.3.6](https://github.com/openfga/go-sdk/releases/tag/v0.3.6)
+- [Javascript v0.4.0](https://github.com/openfga/js-sdk/releases/tag/v0.4.0)
+
+## What's next?
+
+Our next steps look as follows:
+
+1. Release candidate with experimental flag (now)
+2. Any bug fixes
+3. Stable release with experimental flag
+4. Any performance improvements
+5. Stable release without experimental flag
+
+## We want your feedback!
+
+We want to learn how you use this API and how we can improve it!
+
+Please reach out through our [community channels](https://openfga.dev/community) with any questions or feedback.