Shares (short-term invitations)
A share is a short-term invitation: the same access_invite_links resource and the same guest redeem page, not a second permission system.
| Invitation | Share | |
|---|---|---|
| Intent | Planned guest visit | Hand someone the door for a short time |
| Authoring | Photo, message, location, schedules | Duration (TTL) and max uses |
| Uses | Optional / unlimited unless policy requires a cap | Finite by default (system default 1) |
| Lifetime | May remain after expiry | Soft-deleted after valid_to plus a short grace |
| Audit | access_invite.* with kind: invitation | Same events with kind: share |
Create from a door (that door only) or Create share (one or more doors you are allowed to share). Do not offer Share on a guest door that came from a claimed invitation — invitation_no_reshare already forbids transitive sharing.
Duration defaults to 1 day, and uses default to 1. Org policies can raise the share duration cap up to 1 year, and further cap uses. See Max share duration, Default share uses, and Max share uses. Combined with invitation authoring policies, requests that exceed a cap are rejected, not shortened.
On mobile, creating a share opens the system share sheet, then Keep or Discard. Discard deletes the share so an unused link does not stay live.