> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ziik.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing units

> Create, read, update, and delete units (departments, locations, teams) via the API.

Units represent departments, locations, or teams in Ziik. You can manage them fully via the API:

* **List units** – `GET /units` (with optional filters: feature, user membership, search).
* **Create a unit** – `POST /units` with `name` and optional `reference` and `parent` (for hierarchy).
* **Get a unit** – by ID (`GET /units/{unit}`) or by your external key (`GET /units/reference/{unit}`).
* **Update a unit** – `PATCH /units/{unit}` (e.g. name, reference).
* **Delete a unit** – `DELETE /units/{unit}`.

Set a **reference** on units to map them to your own org structure (e.g. cost center or department code) and use `GET /units/reference/{unit}` for lookups.