Skip to content

Concepts

Who can see what

Access is layered, from the sign-in gate down to a single record, and an agent's token is bounded by the person it connects as. Scroll through the layers, then dig into the reference below.

  1. Sign in
  2. Pages
  3. Records
  4. Agents

Scroll

Four questions, asked in order: can this person sign in, which pages exist for them, which records on those pages can they open, and what may an agent do on their behalf. Every layer narrows the one outside it, and none of them widens it.

Three nested boxes labelled sign in, page access, and the record, each one narrowing the one outside it

A person can sign in only if one of two things is true: they already have an active account in the tenant, or their email domain is on the tenant’s allowed sign-in domain list, in which case their first single sign-on provisions the account.

Email and password sign-in exists too, but only where an administrator has enabled it for that account. There is no open self-signup: somebody always grants access first. Deactivating a user cuts off access immediately while leaving their history, approvals, and submissions intact.

Every user is granted specific pages: one per configured item type, plus Dashboards, Templates, Time Keeping, My Items, and Admin. A page a person has not been granted does not appear in their navigation at all, and the direct link is refused with an Access Denied screen naming the area.

A regular new user gets the standard member set and no Admin. Item type pages are granted one at a time, deliberately. There is no Workflows entry to grant: a workflow opens from the item it is attached to.

Underneath page access, each item carries its own visibility, either public or private, and a person can hold an item permission on a specific record: view to open and read it, edit to change it as well. There is one permission row per person per record.

Page access and item access are genuinely separate. Holding an item type’s page does not guarantee you can see every record on it, which is why an open page can still show an empty list.

An agent is always authorized per user, through OAuth or a personal token, and narrowed further by scopes, one required per MCP tool. Scopes only subtract: a token never grants more than the connected person already has, and everything it does is attributed to them.

The admin flag is the one thing that is not a page grant. An administrator reaches every page and can change what everyone else reaches, so promote deliberately and demote as soon as the role no longer needs it.

Role Access
Administrator The full Admin area and tenant configuration, plus implicit access to every page.
Member Regular access, scoped by page access and item permissions.
External A limited account, typically a form respondent who sees only their assigned form and not the surrounding workflow.

Administrators can promote another user to administrator or remove that access: see Users and access.

An item is either public, visible to anyone holding its item type’s page, or private, restricted to the people explicitly attached to it. On top of that, item permissions grant view or edit on individual records, and ownership carries its own access.

Three object types inherit their access from what they are attached to, rather than carrying a permission model of their own:

  • A workflow follows the item it belongs to, plus workflow ownership.
  • A dashboard is either private or public.
  • A document follows the chain up through its step, workflow, and item.

Each MCP tool requires a specific scope:

Tool Required scope
get_schema read:data
query_data read:data
get_current_context read:context
get_step_context read:workflows
upload_document write:documents
download_document read:documents
suggest_change write:suggestions

The full scope list is in Reference.

Agents connect either through an OAuth client an administrator registers, see AI integrations, which is the path for multi-user platforms, or through a personal token for individual use. Personal tokens are generated from the AI Agent Setup page and expire after 30 days.

Whichever path an agent takes, write:suggestions is the scope that lets it propose changes at all, and every proposal still lands as a suggestion for a person to review.

Admin configuration changes and item activity are both logged and reviewable: tenant-wide changes in the activity log, and a single record’s history in its own activity feed. It is the same trail a suggestion’s outcome lands in once it is processed, see Suggestions.

And when an agent acts for someone

Everything on this page bounds agents too. A token authorizes one person, so get_current_context and query_data return exactly that person’s slice of the tenant and nothing wider. Writes go through suggest_change and are applied as the approver, under the approver’s permissions, which is what stops a proposal being used to reach past what its reviewer could have done by hand. Tenant configuration is not a suggestion target at all: no agent creates a user, grants a page, or promotes an administrator.