Sign in

v1

latestOpenAPI 3.1.02026-07-24398280.9 KB
Organization management

Create a functional unit

Use this endpoint to create a new functional unit.

post/v1/organization/functional_units

Request body

namestring required

The name of the functional unit

descriptionstring

The description of the functional unit

defaultDisplayUnitstring required

A unit of measurement (e.g., kg, MWh, etc).

subIndustryCodestring nullable

The sub-industry code of the business entity or functional unit, formatted as eight digits.

measurementType'COUNTER' | 'GAUGE'

The type of measurement of the functional unit. COUNTER is used for attributes that are added across time periods (e.g., steel produced). GAUGE is used for attributes that are not added across time periods (e.g., number of employees).

Example request

{
  "defaultDisplayUnit": "kg"
}

Response

Functional unit created successfully

idstring uuid required
namestring required

The name of the functional unit

descriptionstring

The description of the functional unit

defaultDisplayUnitstring required

A unit of measurement (e.g., kg, MWh, etc).

supportedUnitsUnit[] required
orgIDstring uuid nullable
subIndustryCodestring nullable required

The sub-industry code of the business entity or functional unit, formatted as eight digits.

measurementType'COUNTER' | 'GAUGE'

The type of measurement of the functional unit. COUNTER is used for attributes that are added across time periods (e.g., steel produced). GAUGE is used for attributes that are not added across time periods (e.g., number of employees).

Example response

{
  "defaultDisplayUnit": "kg",
  "supportedUnits": [
    "kg"
  ]
}