> For the complete documentation index, see [llms.txt](https://docs.hiboo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hiboo.io/guides/core-concepts.md).

# Core concepts

Before you touch an endpoint, it helps to know the **core concepts** that make up Hiboo and that appear throughout the API and Application.

## Fleet Administration

Manage the assets you own and the metadata around them.

* **Organization** – It is composed of all your machines, users, zones. It is the logical receptacle of all your data in Hiboo. One user belongs to only one organization.
* **Workspace** – It belongs to an Organization, it is a group of machines, users and zones that you could map to a Business Unit, a Job type or any sub division that makes sense for your enterprise
* **Equipment** – Single machine uniquely identified by an Hiboo ID.
* **Custom Field** – User‑defined metadata that you attach to equipment (e.g., Cost Code, Site).
* **Document** – Any file linked to equipment such as an inspection report, spec sheet or photo.

## Mixed‑Fleet Data

Query harmonized telematics metrics no matter the source.

* **Data Source** – the upstream system supplying raw data (e.g., Caterpillar, Komatsu, Samsara). Managed under **Catalog** in the Hiboo App.
* **Integrations** - Your Organization + A Data Source + Your credentials = an Integration. Managed under **Integrations** in the Hiboo App
* **Data Kind** – a normalized datapoint such as operating hours, fuel %, GPS location or fault code.

## Hiboo Connect (e.g. Data Sharing)

Securely grant partners or customers scoped access to your fleet data.

* **Connect Share** – a time‑bound way that exposes a chosen subset of fleet data to a third party.
* **Scope** – the filters that limit what a share can see (Machine, metrics, date range). Configured when you create or edit a share.