---
title: "Add or edit a folder or a meter. To add a new folder use and empty ID"
method: POST
path: "/api/folder/settings/{id}"
tags: ["FolderSettings"]
---

# Add or edit a folder or a meter. To add a new folder use and empty ID

`POST /api/folder/settings/{id}`

## Path parameters

- `id` string, required

## Request body

- FolderSettings — Container for the folder settings
  - `Description` string — The Description of the folder or meter
  - `Enable` boolean — Flag if the meter is enabled (folder not supported yet)
  - `FolderType` 'Folder' | 'Location' | 'Factory' | 'House' | 'Office' | 'Machine' | 'VirtualMeter' | 'ElecticityFolder' | 'WaterFolder' | 'HeatFolder' | 'GasFolder' | 'TemperatureFolder' | 'Sun' | 'Light' | 'Ice' | 'Sofa' | 'Food' | 'Coffee' | 'Car' | 'ChargingStation' | 'Meter' | 'User' | 'Trash' | 'GridPhotovoltaicPowerSystem' — The Type of the folder
  - `Name` string — The Name of the folder or meter
  - `ParentFolderId` string — The parent folder ID of this item
  - `SerialNumber` integer — The serial number (meter only)
  - `UseableForVirtualBillingMeters` boolean — Flag if the meter is usable for virtual billing meters (e.g. washroom)
  - `ValueCorrection` number, double — The value correction on this meter
  - `ValueCorrectionParentFolder` number, double — The value correction on all parent folders. but not on the meter itself
  - `VisualizationName` string — The name of the visualization of the folder

## Response `200`

OK

- FolderMenuItem — A folder menu item
  - `AutoExportSettings` AutoExportSettings — Settings for the auto export functionality of a meter
    - `ExportFormat` string — The export format
    - `ExportInterval` 'NoExport' | 'Hourly' | 'Daily' | 'Weekly' | 'Monthly' | 'QuaterYearly' | 'HalfYearly' | 'Yearly' — The export interval of the auto export
    - `MeterPointId` string — The meter point id set by the user
    - `UploadType` string — The upload type
  - `Children` FolderMenuItem[] — Children folder menu items (sub folder menu items)
  - `Description` string — The Description of the folder
  - `FolderType` 'Folder' | 'Location' | 'Factory' | 'House' | 'Office' | 'Machine' | 'VirtualMeter' | 'ElecticityFolder' | 'WaterFolder' | 'HeatFolder' | 'GasFolder' | 'TemperatureFolder' | 'Sun' | 'Light' | 'Ice' | 'Sofa' | 'Food' | 'Coffee' | 'Car' | 'ChargingStation' | 'Meter' | 'User' | 'Trash' | 'GridPhotovoltaicPowerSystem' — The folder type of the item
  - `Icon` string — The path to the Icon of this folder
  - `Id` string — The id of the folder menu item
  - `MeterSerialNumber` string — The serial number if the folder menu item is a meter. Serial number is handled as a string, as javascript on client side cannot handle long integers properly.
  - `Name` string — The Name of the item
  - `UserId` string — The ID of the user of this folder (only for foldertype user)

---

[API](https://skmtc.net/smartme/apis/smart-me.md) · [All operations](https://skmtc.net/smartme/apis/smart-me/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartme/smart-me/versions/649342c9f0b1/schema)