ExpandPermissionTree reveals the graph structure for a resource's

permission or relation. This RPC does not recurse infinitely deep and may require multiple calls to fully unnest a deeply nested graph.

POST {{baseUrl}}/v1/permissions/expand

Request Body

{"consistency"=>{"minimizeLatency"=>"<boolean>", "atLeastAsFresh"=>{"token"=>"<string>"}, "atExactSnapshot"=>{"token"=>"<string>"}, "fullyConsistent"=>"<boolean>"}, "resource"=>{"objectType"=>"<string>", "objectId"=>"<string>"}, "permission"=>"<string>"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;expandedAt&quot;:{&quot;token&quot;:&quot;\u003cstring\u003e&quot;},&quot;treeRoot&quot;:{&quot;intermediate&quot;:{&quot;operation&quot;:&quot;OPERATION_UNSPECIFIED&quot;,&quot;children&quot;:[{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/v1PermissionRelationshipTree detected\u003e&quot;},{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/v1PermissionRelationshipTree detected\u003e&quot;}]},&quot;leaf&quot;:{&quot;subjects&quot;:[{&quot;object&quot;:{&quot;objectType&quot;:&quot;\u003cstring\u003e&quot;,&quot;objectId&quot;:&quot;\u003cstring\u003e&quot;},&quot;optionalRelation&quot;:&quot;\u003cstring\u003e&quot;},{&quot;object&quot;:{&quot;objectType&quot;:&quot;\u003cstring\u003e&quot;,&quot;objectId&quot;:&quot;\u003cstring\u003e&quot;},&quot;optionalRelation&quot;:&quot;\u003cstring\u003e&quot;}]},&quot;expandedObject&quot;:{&quot;objectType&quot;:&quot;\u003cstring\u003e&quot;,&quot;objectId&quot;:&quot;\u003cstring\u003e&quot;},&quot;expandedRelation&quot;:&quot;\u003cstring\u003e&quot;}}