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

# Overview & Examples

> Learn how to use the Dimensions & Segments API

<Card icon="github" title="Dimensions and Segments API Example" href="https://github.com/pelanororg/pelanor-dimensions-api-example" target="_blank" rel="noopener">
  A complete, runnable script that creates a Tenant dimension and segments from an input CSV file.
</Card>

Pelanor **Dimensions** let you create business‑aligned views of your cloud‑cost data—​for example, Tenant / Customer, Business Unit, or Feature. Each dimension contains multiple **Segments**, which define individual values and their selection rules.

For details on how Dimensions and Segments work in the Pelanor platform, see the <a href="/features/dimensions">Dimensions</a> guide.

### When to use the Dimensions & Segments API

* **Dynamically update segments** from an external data source (e.g., sync tenant lists from your CRM).
* **Consume dimension metadata** elsewhere (e.g., export dimensions and their selection criteria to CSV).