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
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"expandedAt":{"token":"\u003cstring\u003e"},"treeRoot":{"intermediate":{"operation":"OPERATION_UNSPECIFIED","children":[{"value":"\u003cCircular reference to #/components/schemas/v1PermissionRelationshipTree detected\u003e"},{"value":"\u003cCircular reference to #/components/schemas/v1PermissionRelationshipTree detected\u003e"}]},"leaf":{"subjects":[{"object":{"objectType":"\u003cstring\u003e","objectId":"\u003cstring\u003e"},"optionalRelation":"\u003cstring\u003e"},{"object":{"objectType":"\u003cstring\u003e","objectId":"\u003cstring\u003e"},"optionalRelation":"\u003cstring\u003e"}]},"expandedObject":{"objectType":"\u003cstring\u003e","objectId":"\u003cstring\u003e"},"expandedRelation":"\u003cstring\u003e"}}