Organisations and sites

Who owns what, and where screens are.

Organisation

An organisation is a Vojo customer. It owns its sites, screens, Harvesters, creatives and plays. Everything you read or write through the API is scoped to one organisation, and a secret key belongs to exactly one.

Ids from another organisation return 404, as if they didn't exist.

Site

A site is a physical location, such as a shopping centre or a station. It has an address and can contain many screens.

A site can have operating times. A day can have several opening windows, for example 07:00 to 12:00 and 13:00 to 22:00.

A screen doesn't have to belong to a site, but most do. Site names are unique within an organisation.