chore: list users announcement

blog/list-users-announcement.md

@@ -0,0 +1,29 @@
+---
+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 UIs that want to display the list of users that a resource has been shared with, e.g. the "share" dialog in Google Docs.
+
+## How to use it?
+
+ListUsers is available in the latest Release Candidate version of OpenFGA. To use it you need to download [v1.5.4-RC](TBD) of OpenFGA. Be sure to check out the various configuration flags that were added, too.
+
+## What's next?
+
+We have plans to add a Streaming variant to this endpoint, which will allow you to get results as soon as they are found.
+
+## Reach out!
+
+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.