Permissions

Added · Seed

… to carry out a task, the artifact needs access to something the actor controls outside it—a camera or location sensor, local files, contacts, or an external account such as a calendar or mailbox—either for a feature the actor just triggered or for an agent working under delegation.

Problem

When an artifact asks for broad access up front—before the actor has tried the feature that needs it—actors either click through blindly to get past the barrier or refuse because the request feels invasive. Once access is granted, it stays active out of sight with no obvious way to check what the artifact can still reach or revoke it.

Up-front permission walls ask for a trust decision without context. Studies of mobile and web permissions consistently show that actors rarely read install-time or onboarding scope lists, whereas they readily judge runtime requests that clearly follow from an action they just took. The problem sharpens under delegation: an agent uses connected accounts and tools in the background, and asking for every integration during onboarding forces the actor to hand over wide access before seeing what the agent can do.

Solution

Ask for access at the moment the actor triggers the feature or task that needs it, and state clearly what the access is for. Request the narrowest scope and duration that will serve the task—read-only before read-write, a single item or folder before a whole account, and one-time or session access before a standing grant. If the actor declines, keep the rest of the artifact working and show at the blocked feature how to complete the task another way or grant access later. List all active grants in one place where the actor can inspect and revoke them.

Do not interrupt the actor with a separate prompt for every minor step when a single task needs a handful of related scopes; group the scopes required for that task into one request and let the actor approve or untick them individually.

Continuation

The artifact holds only the access the actor has explicitly granted, and active grants can be reviewed and revoked in settings. Once a source is connected, the actor can attach items from it as reference material. Where an agent uses the connection, permissions settle what it can reach, while bounded autonomy settles what it may do there without asking. A grant given for standing work is withdrawn when the work ends, and one left unused can lapse after a set time, as phones do for apps left unopened. Sharing and roles draw a different line: they govern what other participants may do inside the actor's workspace, whereas permissions govern what the artifact may reach outside itself…

All connections
Precedes
Bounded autonomy — permissions settle what the agent can reach, and bounded autonomy settles what it may do there without asking
Reference material — Once a source is connected, the actor can attach items from it as reference material.
Serves
Delegation — covers the permissions and authorisation touchpoint of delegation's set-up stage
Enacts
Privacy — access to the actor's devices, data, and accounts is granted in scoped parts for a clear purpose and can be revoked
Agency — the actor decides what the artifact can reach and for how long
Related to
Sharing, roles — Sharing and roles draw a different line: they govern what other participants may do inside the actor's workspace, whereas permissions govern what the artifact may reach outside itself
Settings — The artifact holds only the access the actor has explicitly granted, and active grants can be reviewed and revoked in settings.
Appears in
Delegating a task: Handing the work over, step 2
Delegating standing work: Setting it going, step 2; Ending it, step 3

In practice

Scope, duration, and system pickers

  • System pickers before permissions. When the actor only needs to attach a file, choose a photo, or pick a contact once, use the platform’s file, photo, or contact picker. Selecting the item grants access to that item alone without a permission prompt or a standing grant to manage.
  • One-time, session, and standing grants. Where the platform or artifact manages the grant (such as location, microphone, or local folder access for an agent), offer this time, for this session (or while in use), and always. Withdraw session grants automatically when the session closes; if the actor grants the same one-off access repeatedly, offer to make it standing.
  • Incremental and granular account scopes. In OAuth and connector flows, request sign-in first and ask for resource scopes (such as calendar read or message send) only when the actor enables the feature that uses them. Where a feature requests multiple scopes, allow partial grants and adjust the feature to work with whichever scopes the actor approved.

Working with OS and browser prompts

Operating-system and browser permission dialogues have fixed copy, cannot be styled, and lock out further prompts after the actor declines once or twice:

  • Ask on a clear action, or explain first. Trigger the native prompt directly when the actor clicks a control whose label already implies the access (such as “Record audio” or “Use my location”). When the need is not obvious from the control, show a brief in-context explanation first so a “Not now” response does not spend the platform’s one-shot prompt.
  • Degrade gracefully in place. When the actor declines, keep the surrounding workflow usable and offer a manual alternative at the control (such as typing an address instead of sharing location, or uploading an image instead of opening the camera).
  • Guide recovery when blocked by the platform. Once the browser or OS blocks further prompts, clicking the control cannot re-open the native dialogue. Detect the blocked state and show specific instructions for re-enabling access in browser or system settings.

Resources & references