diff --git a/blog/authors.yml b/blog/authors.yml index b6fe0585b..2720fae2c 100644 --- a/blog/authors.yml +++ b/blog/authors.yml @@ -6,4 +6,8 @@ aaguiar: eharris: name: Ewan Harris url: https://github.com/ewanharris - image_url: /img/blog/authors/ewan.jpg \ No newline at end of file + image_url: /img/blog/authors/ewan.jpg +miparnisari: + name: Maria Ines Parnisari + url: https://github.com/miparnisari + image_url: /img/blog/authors/miparnisari.jpg \ No newline at end of file diff --git a/blog/list-users-announcement.md b/blog/list-users-announcement.md new file mode 100644 index 000000000..bdd8c74a3 --- /dev/null +++ b/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. diff --git a/static/img/blog/authors/miparnisari.jpg b/static/img/blog/authors/miparnisari.jpg new file mode 100644 index 000000000..9714b2aed --- /dev/null +++ b/static/img/blog/authors/miparnisari.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:a2d879495991865e2c5e6ed08bb815b02372bb17e052b172b179454be7c0274f +size 1679955