Delete a meter | Solvimon

curl -X DELETE https://test.api.solvimon.com/v1/meters/ \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "reference": "MTR-20240601-001",
  "object_type": "meter",
  "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
  "name": "Main Building Energy Meter",
  "description": "Measures total electricity consumption for the main building",
  "status": "DRAFT",
  "meter_values": [
    {
      "id": "val-1234abcd-5678-ef90-gh12-ijklmnopqrst",
      "object": {
        "reference": "VAL-20240601-001",
        "object_type": "meter_value",
        "id": "val-1234abcd-5678-ef90-gh12-ijklmnopqrst",
        "name": "Electricity Usage",
        "description": "Total kWh consumed",
        "status": "DRAFT",
        "type": "NUMBER"
      },
      "required": true
    }
  ],
  "meter_properties": [
    {
      "id": "prop-9876zyxw-5432-vuts-rqpo-nmlkjihgfedc",
      "object": {
        "reference": "PROP-20240601-001",
        "status": "DRAFT",
        "object_type": "meter_property",
        "id": "prop-9876zyxw-5432-vuts-rqpo-nmlkjihgfedc",
        "name": "Meter Type",
        "description": "Type of meter installed",
        "type": "NUMBER",
        "enum_values": [
          "1-phase",
          "3-phase",
          "solar",
          "gas"
        ]
      },
      "required": true
    }
  ]
}

Requires the METER.DELETE permission.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

versionstringRequiredDefaults to 1

version

resourceIdOrReferencestringRequiredDefaults to

The ID or reference of the resource.

Response

referencestringformat: "^\S+$"0-256 characters

object_typestring or nullRead-only

idstring or nullRead-only

namestring or nullformat: "^.*$"0-256 characters

descriptionstring or nullformat: "^.*$"0-256 characters

statusenum or null

The status of the meter indicating the activity of the meter and the ability to update properties.

Allowed values:

meter_valueslist of objects or null

The values used as input to calculate billable units, used in the meter.

meter_propertieslist of objects or null

The properties that provide information to give context to an event, used in the meter.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

Authentication

Path parameters

Headers

Response

Errors