Create a one-time location-share code
POST/v2/locator/share-token
Consumer live-location sharing ("find my partner"), gated by per-viewer
pairings instead of a single shared static ID — the token below is
short-lived (15 minutes) and single-use; the recipient redeems it into
a pairing tied to their own account at /v2/locator/redeem. You can
then revoke that one person at /v2/locator/viewers/{pairingId}
without affecting anyone else you've shared with.
share_duration_hours bounds how long the resulting pairing stays
active once redeemed (omit for permanent-until-revoked, max 720 = 30
days).
Request
Responses
- 201
- 400
- 403
Token created
Validation error (e.g. share_duration_hours out of range)
The endpoint requires an account-scoped API key. Legacy keys without an account identity cannot access tenant data. Also returned when the requested resource (loan, schedule) is registered to another account.