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

# KODE API reference

> Browse KODE API endpoints, switch code samples by language, and send test requests from the browser or Postman.

Every endpoint page lists its parameters, request body, and response. The panel on the right has a language menu and a form that sends the request.

## Switch the code sample

Open any endpoint, such as [List buildings](https://docs.kodelabs.com/products/kode-api/api-reference/buildings/list-buildings.md). Use the language menu above the sample to switch between cURL, JavaScript, Python, and PowerShell. The sample updates in place.

## Send the request from the browser

**1. Get an access token**

Follow the [quickstart](https://docs.kodelabs.com/products/kode-api/quickstart.md). Copy the `access_token` value.

**2. Open the playground**

Open [List buildings](https://docs.kodelabs.com/products/kode-api/api-reference/buildings/list-buildings.md?playground=open) and select **Try it**.

**3. Authorize and send**

Paste the token into `Authorization`, then select **Send**. The response appears under the sample.

> [!WARNING]
>
> The playground sends real requests to your KODE environment. Write endpoints, such as point writes and work order updates, change live data.

## Run the collection in Postman

Fork the collection if you want saved requests, environments, and tests in Postman. After you fork it, set `KODE_ACCESS_TOKEN` in a Postman environment and send any request.

> [card] [Fork in Postman](https://elements.getpostman.com/view/fork?collection=37847641-0db06e08-772a-492b-9a93-f5d18c67b15c\&documenterCollectionId=37847641-0db06e08-772a-492b-9a93-f5d18c67b15c-2sAYkEqfGB\&referrer=https%3A%2F%2Fdocumenter.getpostman.com%2Fview%2F37847641%2F2sAYkEqfGB\&versionTag=latest\&source=documenter)
>
> Copy the KODE API collection into your Postman workspace, then run the requests there.

You can also download the OpenAPI specification from the page menu and import that file into Postman. The published [KODE API collection](https://documenter.getpostman.com/view/37847641/2sAYkEqfGB) is the same collection the fork button copies.

## Find identifiers

Most endpoints need an identifier from an earlier call:

| Identifier | Where to get it |
| - | - |
| `buildingId` | [List buildings](https://docs.kodelabs.com/products/kode-api/api-reference/buildings/list-buildings.md) |
| `datasourceId` | [List building data sources](https://docs.kodelabs.com/products/kode-api/api-reference/data-sources/list-building-data-sources.md) |
| `deviceId` | [List building devices](https://docs.kodelabs.com/products/kode-api/api-reference/devices/list-building-devices.md) |
| `pointId` | [List building points](https://docs.kodelabs.com/products/kode-api/api-reference/points/list-building-points.md) |
| `workOrderId` | [List work orders](https://docs.kodelabs.com/products/kode-api/api-reference/work-orders/list-work-orders.md) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.