Organizations

Overview

Organizations and their software partners can add, update or remove sites for all of their users in one call. The sites land on each user's own account as ordinary locations: they show up in that user's dashboard and app and alert exactly as if the user had added them.

Each site carries your own external_id, so calls are idempotent. Sending the same payload again changes nothing. sync makes each user's organization-managed sites exactly match your list, and never touches locations users created themselves.

Members can rename or move a site you manage, and later calls keep the values they changed. Only your organization's administrators, your API key or sync can remove a managed site; a member who tries gets 403 with code ORG_MANAGED_LOCATION. A site an administrator deleted in the app is skipped by later calls instead of coming back. Two explicit flags override this when you need to.

Target every member, a list of users, email addresses, your own member ids, or a segment of members by tag. Results come back per user and site, so one problem row never fails the rest.

Authentication

Call with a secret API key (X-Flash-Api-Key: fw_sk_...) for an organization that holds the Organizations API key product, or with the user token of one of the organization's administrators. Either way the call only ever reaches members of that one organization.

Typical uses

Field-service and job-management systems pushing today's job sites to every crew member's alerts, franchise and multi-site operators keeping each manager's sites in step with a central list, and partners onboarding an organization's sites without anyone re-entering them.

Operations