Access views reference - Qobra public API documentation

The saved views array under each shareable resource in the Access object reference — statement, request, quota and data_table all use this exact shape.

Shape

object[]

The saved views you may pass as the view_id argument of this resource’s list tool. Each view carries its own access roster — roles and users who can read it — populated when you may share the resource, null otherwise. In get_identity, the roles that reach the view only through their category access are listed once on the resource, in category_roles, rather than in each view’s access.roles.

Show object properties

string

object

Who can read this view, split into roles and users, each with the level they hold. Only the tools that list views for you to choose between resolve it — list_quotas, list_data_tables and get_identity — and only for callers who may share the resource. Null everywhere else, so null is silence about the roster (either not asked for, or not yours to see), never an empty one: a caller who may see it and finds nobody gets empty roles and users instead. get_identity lists the roles that reach every view through their access to the whole category once on the resource (category_roles), not on each view: there a role appears in roles only for the share it holds on this view, with its shared_access.

Show object properties

object[]

Show object properties

object

Show object properties

string

The level this role holds on the whole resource category, which reaches every view of it without a share — read (view it), write (edit and re-share it) or delete (also remove it), each level including the ones before it. Null when the role only got this view through a share. One of: read, write, delete.

string

The level granted to this role on this view specifically — read (view it), write (edit and re-share it) or delete (also remove it), each level including the ones before it. Null when the role reaches the view through its category access rather than a share. One of: read, write, delete.

object[]

Show object properties

object

Show object properties

string

The level this view is shared with the user at, individually, on top of whatever their role already grants — read (view it), write (edit and re-share it) or delete (also remove it), each level including the ones before it. One of: read, write, delete.

​Shape

Shape