Skip to main content

Organisation Hierarchy

Overview​

The Bullitt e-BSS platform uses a hierarchical organisation structure that allows for efficient management of devices, reporting, and access control. Understanding this hierarchy is fundamental to using the API effectively.

Organisation Structure​

Organisations in the Bullitt e-BSS system are arranged in a tree structure:

  • Root Organisation: The top-level organisation in your hierarchy
  • Sub-Organisations: Child organisations that exist under parent organisations
  • Multi-level Hierarchy: Sub-organisations can have their own sub-organisations, creating a multi-level tree

This structure enables enterprises to organize their satellite devices by department, region, project, or any other logical grouping that suits their business needs.

Organisation IDs and "self"​

Throughout the API, you'll work with organisation identifiers:

  • Each organisation has a unique organisationId (e.g., "org_001")
  • For convenience, you can use "self" in place of an organisation ID to refer to the organisation associated with your API key
GET /organisations/self