Skip to content

Sharing

Invite a teammate to one app, or a whole group, with a role that limits what they can do to it.

Roles

RoleCan do
OwnerEverything: rename, pause, archive, delete, links, group, tags, members, billing
EditorRead, acknowledge, snooze, resolve or mark alerts not applicable, upload manifests
ViewerRead only

Only the owner can rename an app, pause, archive or delete it, change its links, group or tags, manage members, or touch billing. An editor can do everything day to day: upload a fresh manifest, and acknowledge, snooze, resolve or mark an alert not applicable. A viewer can look but not change anything.

Inviting someone

  1. From an app page or a group page, the owner enters an email address and picks a role.
  2. An invite email goes out naming who invited them, the app or group, and the role. Inviting the same address again replaces the outstanding invite rather than sending a second one.
  3. The invite link expires after 7 days if nobody accepts it.
  4. Accepting sends the recipient straight to the shared app or group, signed in the normal way (magic link or GitHub) if they were not already.

Group sharing

Sharing a group gives that role on every app in it, including apps added to the group later. Access is worked out at the moment someone reads or writes, not stored per app, so moving an app into or out of a group changes what a member of that group can see immediately.

Who sees what

The owner sees a Members panel listing current members with a Remove action, pending invites with a Revoke action, and the invite form. A member sees only a Leave action. Apps shared with you show up on your apps list under their own “Shared with you” heading, and in a digest under the same heading.

Billing is unaffected

Sharing never changes who pays

Slots and billing are counted from the app's owner alone. Adding a member, however many apps they can see through membership, never counts against their own app limit and never changes the owner's bill.

API access

A member's API key carries their own access, including anything shared with them. An editor's key can upload manifests and change alert status on a shared app; a viewer's key cannot. GET /api/v1/me/export lists shared apps alongside your own, each with the role you hold. See the API page.

Sharing | VibeBeacon