Expand call is a call to the Authzed API to expand the contents and structure of relation) for a particular object, under a namespace.
Expand calls are usually used when you need to learn the membership of a relation for a particular object: By calling Expand, a tree is returned containing the entire set of Tuples in the relation for that object, as well as how those tuples were "reached", starting at the requested relation.
Expand call is formed by specifying the relation on which to expand.
To make an expand call, issue an
ExpandRequest to the API:
Expand call will return the expanded membership tree of the relation.
For example, imagine if we had this relation:
read would return something along the lines of:
Notice that the tree matches the structure of the definition of the
read relation, and returns all the users found under which subtree.