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

# Permissions Reference

> Reference for service account permission scopes and operations

Each service account defines access through per-scope permissions. Permissions are classified as `Read` or `Write` and determine what the integration can do with each resource. After creating a service account, open its **Permissions** page to define access. Use the permissions reference below to see what scopes and operations are available.

<Note>
  Enable only the permissions your integration requires. Granting broader access than necessary increases your security surface area.
</Note>

### General

Basic building information such as name, address, and configuration.

<Expandable title="General" defaultOpen={true}>
  <ParamField path="Get Buildings" type="Read">
    Retrieve basic building information such as name, address, and configuration details.
  </ParamField>
</Expandable>

### Actions

Building actions such as automated commands or system-level responses.

<Expandable title="Actions" defaultOpen={true}>
  <ParamField path="Get Actions" type="Read">
    Retrieve building actions, such as automated commands or system-level responses.
  </ParamField>
</Expandable>

### AreasPublic

Building areas such as floors, wings, or common spaces.

<Expandable title="AreasPublic" defaultOpen={true}>
  <ParamField path="Get areas" type="Read">
    Retrieve building areas, such as floors, wings, or common spaces.
  </ParamField>
</Expandable>

### DatasourcesPublic

Data source configurations such as BMS integrations or IoT gateways.

<Expandable title="DatasourcesPublic" defaultOpen={true}>
  <ParamField path="Get Datasources" type="Read">
    Retrieve data source configurations, such as BMS integrations or IoT gateways.
  </ParamField>
</Expandable>

### DevicesPublic

Devices such as controllers, sensors, or actuators connected through a data source.

<Expandable title="DevicesPublic" defaultOpen={true}>
  <ParamField path="Get devices" type="Read">
    Retrieve device data, such as controllers, sensors, or actuators connected through a data source.
  </ParamField>

  <ParamField path="Create Devices" type="Write">
    Create new devices.
  </ParamField>
</Expandable>

### MetersPublic

Meters and meter assignments for energy or utility tracking.

<Expandable title="MetersPublic" defaultOpen={true}>
  <ParamField path="Get meter" type="Read">
    Retrieve a single meter.
  </ParamField>

  <ParamField path="List meters" type="Read">
    Retrieve every meter in the building.
  </ParamField>

  <ParamField path="Create meter assignment" type="Write">
    Assign a meter to a resource.
  </ParamField>

  <ParamField path="Create meter reference" type="Write">
    Create a meter reference.
  </ParamField>

  <ParamField path="Delete meter" type="Write">
    Remove a meter.
  </ParamField>

  <ParamField path="Delete meter assignment" type="Write">
    Remove a meter assignment.
  </ParamField>

  <ParamField path="Delete meter reference" type="Write">
    Remove a meter reference.
  </ParamField>

  <ParamField path="Update meter" type="Write">
    Modify an existing meter.
  </ParamField>
</Expandable>

### PointsPublic

Data points such as temperature readings, set points, or equipment status values.

<Expandable title="PointsPublic" defaultOpen={true}>
  <ParamField path="Get points" type="Read">
    Retrieve data points, such as temperature readings, set points, or equipment status values.
  </ParamField>

  <ParamField path="Create Points" type="Write">
    Create new data points.
  </ParamField>
</Expandable>

### SpacesPublic

Spaces and their meter associations within a building.

<Expandable title="SpacesPublic" defaultOpen={true}>
  <ParamField path="Get space" type="Read">
    Retrieve a single space.
  </ParamField>

  <ParamField path="Get space meters" type="Read">
    Retrieve meter data for a space.
  </ParamField>

  <ParamField path="List spaces" type="Read">
    Retrieve all spaces.
  </ParamField>

  <ParamField path="Batch create spaces" type="Write">
    Create multiple spaces at once.
  </ParamField>

  <ParamField path="Batch update spaces" type="Write">
    Update multiple spaces at once.
  </ParamField>

  <ParamField path="Create space" type="Write">
    Create a single space.
  </ParamField>

  <ParamField path="Update space" type="Write">
    Modify an existing space.
  </ParamField>
</Expandable>

### TenantsPublic

Tenants and tenant assignments for the building.

<Expandable title="TenantsPublic" defaultOpen={true}>
  <ParamField path="Get tenant" type="Read">
    Retrieve a single tenant.
  </ParamField>

  <ParamField path="Get tenant assignments" type="Read">
    Retrieve tenant assignments.
  </ParamField>

  <ParamField path="List tenants" type="Read">
    Retrieve all tenants.
  </ParamField>

  <ParamField path="Create tenant" type="Write">
    Create a new tenant.
  </ParamField>

  <ParamField path="Delete tenant" type="Write">
    Remove a tenant.
  </ParamField>

  <ParamField path="Update tenant" type="Write">
    Modify an existing tenant.
  </ParamField>
</Expandable>

### TimeseriesPublic

Time-series data for trend analysis, reporting, and energy calculations.

<Expandable title="TimeseriesPublic" defaultOpen={true}>
  <ParamField path="Get Timeseries" type="Read">
    Retrieve time-series data for trend analysis, reporting, and energy calculations.
  </ParamField>

  <ParamField path="Create Timeseries" type="Write">
    Write new time-series data.
  </ParamField>
</Expandable>

### WorkOrdersPublic

Work orders for maintenance tasks, repair requests, and scheduled activities.

<Expandable title="WorkOrdersPublic" defaultOpen={true}>
  <ParamField path="Get WorkOrders" type="Read">
    Retrieve work orders for maintenance tasks, repair requests, and scheduled activities.
  </ParamField>

  <ParamField path="Create WorkOrders" type="Write">
    Create new work orders.
  </ParamField>
</Expandable>