Skip to content

Access Level

An Access Level is a named preset of Permissions a Worker holds in a namespace, such as owner or viewer; it is never a Role.

Properties

PropertyTypeRequiredDescription
namestringrequiredIts name, such as owner, admin, member, or viewer.
grantslist of PermissionrequiredThe Permissions it presets: read, write or all Verbs, or named Verbs, on Nouns.
orderintegerIts rank: 1 holds the most access.

Object

JSON
{
  "$id": "https://api.sb/patentpad.com/access-levels/access_level_1",
  "$type": "AccessLevel",
  "name": "owner",
  "grants": [
    "permission_1"
  ],
  "order": 1
}

Relationships

  • An Access Level has many Workers: a Worker holds one Access Level in each namespace it works in, apart from the Role it fills. workers, inverse hasAccess.

Verbs

  1. getReturns one Access Level by id.
    GET /{namespace}/access-levels/{id}readNo Event
  2. listReturns Access Levels, newest first, one page at a time.
    GET /{namespace}/access-levelsreadNo Event

An Access Level is kept forever and never edited: it has no update or delete.

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
AccessLevel.getYesYesYesYes
AccessLevel.listYesYesYesYes

Call it

Text
Show me the latest access level.

Example

A design contractor joins a Startup as a member. They can edit Offers and Pages, but not a Permission or a Limit. The same person fills the Designer Role: the Access Level sets what they may touch, and the Role sets the work they own.