> For the complete documentation index, see [llms.txt](https://docs.blynk.io/en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blynk.io/en/blynk.cloud/platform-https-api/models.md).

# Models

## The Organization object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"Organization":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Organization unique identifier"},"name":{"type":"string","description":"Organization name"},"description":{"type":"string","description":"Organization description"},"parentOrganizationId":{"type":"integer","format":"int32","description":"Parent organization ID (for hierarchical structure)"},"tz":{"type":"string","description":"A timezone, associated with the organization"},"unitSystem":{"type":"string","enum":["IMPERIAL","METRIC"],"description":"Unit system used in the organization."},"phoneNumber":{"type":"string","description":"Phone number, associated with the organization."},"address":{"$ref":"#/components/schemas/Address"},"lastModifiedTs":{"type":"integer","format":"int64","description":"Timestamp, indicating the time, when the organization was modified last time (Unix epoch milliseconds)"}},"required":["id","name","tz","lastModifiedTs"]},"Address":{"type":"object","properties":{"fullAddress":{"type":"string","maxLength":512,"description":"Full address"},"country":{"type":"string","maxLength":74,"description":"Country name"},"city":{"type":"string","maxLength":50,"description":"City name"},"state":{"type":"string","maxLength":40,"description":"State or province"},"zip":{"type":"string","maxLength":12,"description":"Postal code"}}}}}}
```

## The Device object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"Device":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Device ID"},"name":{"type":"string","description":"Device name"},"templateId":{"type":"integer","format":"int32","description":"Template ID this device belongs to"},"originalTemplateId":{"type":"integer","format":"int32","description":"Original template ID from the template hierarchy (the root template ID this device is ultimately derived from)"},"orgId":{"type":"integer","format":"int32","description":"Organization ID this device belongs to"},"token":{"type":"string","description":"Device authentication token"},"activatedAt":{"type":"integer","format":"int64","description":"Device activation timestamp"},"ownerUserId":{"type":"integer","format":"int64","description":"Device owner identifier"},"hardwareInfo":{"$ref":"#/components/schemas/DeviceHardwareInfo"}},"required":["id","name","templateId","originalTemplateId","orgId","token"]},"DeviceHardwareInfo":{"type":"object","properties":{"version":{"type":"string","description":"Device firmware version"},"fwType":{"type":"string","description":"Device firmware type"},"blynkVersion":{"type":"string","description":"Version of the Blynk Library, that is used on the device"},"boardType":{"$ref":"#/components/schemas/BoardType"},"build":{"type":"string","description":"Firmware build number, that is used on the device"},"templateId":{"type":"string","description":"The identifier of the template that the device belongs to."}}},"BoardType":{"type":"string","enum":["Arduino","BBC_Microbit","ESP32","ESP8266","Lantronix_Fox_3","Microduino","Onion_Omega","Particle","Pycom_WiPy","Raspberry_Pi","Seeed_Wio_Terminal","SparkFun_Blynk_Board","Teensy","TinyDuino","NodeRed","Python","TI_CC3220","Iridium","Iridium_9704_Launch_Pad","NCD","Milesight","Seeed","Blues","MOKOSmart","Thermokon","Miromiko","Pepperl_Fuchs","Atim","Other"],"description":"Device board type"}}}}
```

## The DeviceBasicInfo object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceBasicInfo":{"allOf":[{"$ref":"#/components/schemas/Device"},{"type":"object","properties":{"lifecycleStatus":{"type":"object","description":"Current device lifecycle status","properties":{"eventId":{"type":"integer","format":"int32","description":"Identifier of event, that is used as a lifecycle status"},"name":{"type":"string","description":"Lifecycle status name"},"color":{"type":"string","description":"Lifecycle status color"},"icon":{"type":"string","description":"Lifecycle status icon"}}},"firstConnectTime":{"type":"integer","format":"int64","description":"Device first connection timestamp"},"firmwareUpdatedAt":{"type":"integer","format":"int64","description":"Timestamp, when the device firmware was last updated"},"connectTime":{"type":"integer","format":"int64","description":"Timestamp, when the device has been connected last time"},"disconnectTime":{"type":"integer","format":"int64","description":"Timestamp, when the device has been disconnected last time"},"ip":{"type":"string","format":"ipv4","description":"IP address the device used for connecting"},"lastReceivedEventAt":{"type":"integer","format":"int64","description":"Timestamp, when the device has reported an event last time"},"lastReportedAt":{"type":"integer","format":"int64","description":"Timestamp, when the device has updated the datastream value last time"}},"required":["lifecycleStatus"]}]},"Device":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Device ID"},"name":{"type":"string","description":"Device name"},"templateId":{"type":"integer","format":"int32","description":"Template ID this device belongs to"},"originalTemplateId":{"type":"integer","format":"int32","description":"Original template ID from the template hierarchy (the root template ID this device is ultimately derived from)"},"orgId":{"type":"integer","format":"int32","description":"Organization ID this device belongs to"},"token":{"type":"string","description":"Device authentication token"},"activatedAt":{"type":"integer","format":"int64","description":"Device activation timestamp"},"ownerUserId":{"type":"integer","format":"int64","description":"Device owner identifier"},"hardwareInfo":{"$ref":"#/components/schemas/DeviceHardwareInfo"}},"required":["id","name","templateId","originalTemplateId","orgId","token"]},"DeviceHardwareInfo":{"type":"object","properties":{"version":{"type":"string","description":"Device firmware version"},"fwType":{"type":"string","description":"Device firmware type"},"blynkVersion":{"type":"string","description":"Version of the Blynk Library, that is used on the device"},"boardType":{"$ref":"#/components/schemas/BoardType"},"build":{"type":"string","description":"Firmware build number, that is used on the device"},"templateId":{"type":"string","description":"The identifier of the template that the device belongs to."}}},"BoardType":{"type":"string","enum":["Arduino","BBC_Microbit","ESP32","ESP8266","Lantronix_Fox_3","Microduino","Onion_Omega","Particle","Pycom_WiPy","Raspberry_Pi","Seeed_Wio_Terminal","SparkFun_Blynk_Board","Teensy","TinyDuino","NodeRed","Python","TI_CC3220","Iridium","Iridium_9704_Launch_Pad","NCD","Milesight","Seeed","Blues","MOKOSmart","Thermokon","Miromiko","Pepperl_Fuchs","Atim","Other"],"description":"Device board type"}}}}
```

## The DeviceDetails object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceDetails":{"allOf":[{"$ref":"#/components/schemas/DeviceBasicInfo"},{"type":"object","properties":{"dataStreamValues":{"type":"array","items":{"$ref":"#/components/schemas/DataStreamValue"},"description":"Current datastream values"},"metaFieldValues":{"type":"array","items":{"$ref":"#/components/schemas/MetaFieldValue"},"description":"Device metadata field values"}}}]},"DeviceBasicInfo":{"allOf":[{"$ref":"#/components/schemas/Device"},{"type":"object","properties":{"lifecycleStatus":{"type":"object","description":"Current device lifecycle status","properties":{"eventId":{"type":"integer","format":"int32","description":"Identifier of event, that is used as a lifecycle status"},"name":{"type":"string","description":"Lifecycle status name"},"color":{"type":"string","description":"Lifecycle status color"},"icon":{"type":"string","description":"Lifecycle status icon"}}},"firstConnectTime":{"type":"integer","format":"int64","description":"Device first connection timestamp"},"firmwareUpdatedAt":{"type":"integer","format":"int64","description":"Timestamp, when the device firmware was last updated"},"connectTime":{"type":"integer","format":"int64","description":"Timestamp, when the device has been connected last time"},"disconnectTime":{"type":"integer","format":"int64","description":"Timestamp, when the device has been disconnected last time"},"ip":{"type":"string","format":"ipv4","description":"IP address the device used for connecting"},"lastReceivedEventAt":{"type":"integer","format":"int64","description":"Timestamp, when the device has reported an event last time"},"lastReportedAt":{"type":"integer","format":"int64","description":"Timestamp, when the device has updated the datastream value last time"}},"required":["lifecycleStatus"]}]},"Device":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Device ID"},"name":{"type":"string","description":"Device name"},"templateId":{"type":"integer","format":"int32","description":"Template ID this device belongs to"},"originalTemplateId":{"type":"integer","format":"int32","description":"Original template ID from the template hierarchy (the root template ID this device is ultimately derived from)"},"orgId":{"type":"integer","format":"int32","description":"Organization ID this device belongs to"},"token":{"type":"string","description":"Device authentication token"},"activatedAt":{"type":"integer","format":"int64","description":"Device activation timestamp"},"ownerUserId":{"type":"integer","format":"int64","description":"Device owner identifier"},"hardwareInfo":{"$ref":"#/components/schemas/DeviceHardwareInfo"}},"required":["id","name","templateId","originalTemplateId","orgId","token"]},"DeviceHardwareInfo":{"type":"object","properties":{"version":{"type":"string","description":"Device firmware version"},"fwType":{"type":"string","description":"Device firmware type"},"blynkVersion":{"type":"string","description":"Version of the Blynk Library, that is used on the device"},"boardType":{"$ref":"#/components/schemas/BoardType"},"build":{"type":"string","description":"Firmware build number, that is used on the device"},"templateId":{"type":"string","description":"The identifier of the template that the device belongs to."}}},"BoardType":{"type":"string","enum":["Arduino","BBC_Microbit","ESP32","ESP8266","Lantronix_Fox_3","Microduino","Onion_Omega","Particle","Pycom_WiPy","Raspberry_Pi","Seeed_Wio_Terminal","SparkFun_Blynk_Board","Teensy","TinyDuino","NodeRed","Python","TI_CC3220","Iridium","Iridium_9704_Launch_Pad","NCD","Milesight","Seeed","Blues","MOKOSmart","Thermokon","Miromiko","Pepperl_Fuchs","Atim","Other"],"description":"Device board type"},"DataStreamValue":{"type":"object","properties":{"dataStreamId":{"type":"integer","format":"int32","description":"DataStream ID"},"pin":{"type":"string","description":"DataStream pin"},"dataStreamLabel":{"type":"string","description":"DataStream label"},"dataStreamAlias":{"type":"string","description":"DataStream alias"},"value":{"$ref":"#/components/schemas/DataStreamRawValue"},"updatedAt":{"type":"integer","format":"int64","description":"Last update timestamp"}},"required":["dataStreamId","pin","dataStreamLabel","dataStreamAlias"]},"DataStreamRawValue":{"oneOf":[{"type":"string","description":"String datastream value"},{"type":"number","format":"double","description":"Double, integer or enum datastream value"},{"type":"array","description":"Location datastream value. Represented as an array of two elements, where the first is longitude, and the second is latitude.","items":{"type":"number","format":"double"},"minItems":2,"maxItems":2}]},"MetaFieldValue":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"MetaField ID"},"name":{"type":"string","description":"MetaField name"},"isMandatory":{"type":"boolean","description":"Mark whether the metafield is required"},"includeInProvision":{"type":"boolean","description":"Mark whether the metafield should be included in the provisioning flow"},"value":{"nullable":true,"description":"Metafield value. The schema depends on the `type` discriminator property.","discriminator":{"propertyName":"type","mapping":{"MultiText":"#/components/schemas/MultiTextMetafieldValue","Text":"#/components/schemas/TextMetafieldValue","Email":"#/components/schemas/EmailMetafieldValue","Number":"#/components/schemas/NumberMetafieldValue","Int":"#/components/schemas/IntMetafieldValue","Range":"#/components/schemas/RangeMetafieldValue","Shift":"#/components/schemas/ShiftMetafieldValue","Switch":"#/components/schemas/SwitchMetafieldValue","Cost":"#/components/schemas/CostMetafieldValue","Contact":"#/components/schemas/ContactMetafieldValue","Measurement":"#/components/schemas/MeasurementMetafieldValue","Time":"#/components/schemas/TimeMetafieldValue","Coordinates":"#/components/schemas/CoordinatesMetafieldValue","Address":"#/components/schemas/AddressMetafieldValue","List":"#/components/schemas/ListMetafieldValue","Table":"#/components/schemas/TableMetafieldValue","DeviceReference":"#/components/schemas/DeviceReferenceMetafieldValue","Location":"#/components/schemas/LocationMetafieldValue","Tz":"#/components/schemas/TzMetafieldValue","Image":"#/components/schemas/ImageMetafieldValue","DeviceName":"#/components/schemas/DeviceNameMetafieldValue","DeviceOwner":"#/components/schemas/DeviceOwnerMetafieldValue","HotspotName":"#/components/schemas/HotspotNameMetafieldValue","Imei":"#/components/schemas/ImeiMetafieldValue","ICCID":"#/components/schemas/ICCIDMetafieldValue","DeviceEui":"#/components/schemas/DeviceEuiMetafieldValue","JoinEui":"#/components/schemas/JoinEuiMetafieldValue","ApplicationKey":"#/components/schemas/ApplicationKeyMetafieldValue","BluesDevice":"#/components/schemas/BluesDeviceMetafieldValue","TheThingsNetwork":"#/components/schemas/TheThingsNetworkMetafieldValue","ThingName":"#/components/schemas/ThingNameMetafieldValue","OTASettings":"#/components/schemas/OTASettingsMetafieldValue","MyriotaTerminalId":"#/components/schemas/MyriotaTerminalIdMetafieldValue"}},"oneOf":[{"$ref":"#/components/schemas/MultiTextMetafieldValue"},{"$ref":"#/components/schemas/TextMetafieldValue"},{"$ref":"#/components/schemas/EmailMetafieldValue"},{"$ref":"#/components/schemas/NumberMetafieldValue"},{"$ref":"#/components/schemas/IntMetafieldValue"},{"$ref":"#/components/schemas/RangeMetafieldValue"},{"$ref":"#/components/schemas/ShiftMetafieldValue"},{"$ref":"#/components/schemas/SwitchMetafieldValue"},{"$ref":"#/components/schemas/CostMetafieldValue"},{"$ref":"#/components/schemas/ContactMetafieldValue"},{"$ref":"#/components/schemas/MeasurementMetafieldValue"},{"$ref":"#/components/schemas/TimeMetafieldValue"},{"$ref":"#/components/schemas/CoordinatesMetafieldValue"},{"$ref":"#/components/schemas/AddressMetafieldValue"},{"$ref":"#/components/schemas/ListMetafieldValue"},{"$ref":"#/components/schemas/TableMetafieldValue"},{"$ref":"#/components/schemas/DeviceReferenceMetafieldValue"},{"$ref":"#/components/schemas/LocationMetafieldValue"},{"$ref":"#/components/schemas/TzMetafieldValue"},{"$ref":"#/components/schemas/ImageMetafieldValue"},{"$ref":"#/components/schemas/DeviceNameMetafieldValue"},{"$ref":"#/components/schemas/DeviceOwnerMetafieldValue"},{"$ref":"#/components/schemas/HotspotNameMetafieldValue"},{"$ref":"#/components/schemas/ImeiMetafieldValue"},{"$ref":"#/components/schemas/ICCIDMetafieldValue"},{"$ref":"#/components/schemas/DeviceEuiMetafieldValue"},{"$ref":"#/components/schemas/JoinEuiMetafieldValue"},{"$ref":"#/components/schemas/ApplicationKeyMetafieldValue"},{"$ref":"#/components/schemas/BluesDeviceMetafieldValue"},{"$ref":"#/components/schemas/TheThingsNetworkMetafieldValue"},{"$ref":"#/components/schemas/ThingNameMetafieldValue"},{"$ref":"#/components/schemas/OTASettingsMetafieldValue"},{"$ref":"#/components/schemas/MyriotaTerminalIdMetafieldValue"}]}}},"MultiTextMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["MultiText"],"description":"MetaField value type"},"values":{"type":"array","items":{"type":"string","maxLength":200},"description":"List of text values","maxItems":10000}},"required":["type"]},"TextMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Text"],"description":"MetaField value type"},"value":{"type":"string","description":"Text value","maxLength":200}},"required":["type"]},"EmailMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Email"],"description":"MetaField value type"},"value":{"type":"string","format":"email","description":"Email address value","maxLength":255}},"required":["type"]},"NumberMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Number"],"description":"MetaField value type"},"value":{"type":"number","format":"double","description":"Numeric value"}},"required":["type","value"]},"IntMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Int"],"description":"MetaField value type"},"value":{"type":"integer","format":"int32","description":"Integer value"}},"required":["type","value"]},"RangeMetafieldValue":{"type":"object","description":"Time range value. `from` and `to` are represented as seconds since midnight (0–86399).","properties":{"type":{"type":"string","enum":["Range"],"description":"MetaField value type"},"from":{"type":"integer","format":"int32","description":"Start time as seconds since midnight"},"to":{"type":"integer","format":"int32","description":"End time as seconds since midnight"}},"required":["type"]},"ShiftMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Shift"],"description":"MetaField value type"},"shifts":{"type":"array","items":{"type":"object","description":"A named time range. `from` and `to` are represented as seconds since midnight (0–86399).","properties":{"name":{"type":"string","description":"Shift name","maxLength":200},"from":{"type":"integer","format":"int32","description":"Start time as seconds since midnight"},"to":{"type":"integer","format":"int32","description":"End time as seconds since midnight"}}},"maxItems":10000,"description":"List of shifts"}},"required":["type"]},"SwitchMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Switch"],"description":"MetaField value type"},"value":{"type":"string","description":"Currently selected switch option","maxLength":200},"from":{"type":"string","description":"Label for the \"off\" option","maxLength":200},"to":{"type":"string","description":"Label for the \"on\" option","maxLength":200}},"required":["type"]},"CostMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Cost"],"description":"MetaField value type"},"currency":{"type":"string","description":"ISO 4217 currency code"},"price":{"type":"number","format":"double","description":"Price value"},"perValue":{"type":"number","format":"double","description":"Per-unit value"},"units":{"$ref":"#/components/schemas/MeasurementUnits"}},"required":["type"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"ContactMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Contact"],"description":"MetaField value type"},"firstName":{"type":"string","description":"First name","maxLength":200},"lastName":{"type":"string","description":"Last name","maxLength":200},"email":{"type":"string","format":"email","description":"Email address","maxLength":255},"phone":{"type":"string","description":"Phone number","maxLength":200},"streetAddress":{"type":"string","description":"Street address line 1","maxLength":200},"streetAddress2":{"type":"string","description":"Street address line 2","maxLength":200},"country":{"type":"string","description":"Country","maxLength":200},"city":{"type":"string","description":"City","maxLength":200},"state":{"type":"string","description":"State or province","maxLength":200},"zip":{"type":"string","description":"ZIP or postal code","maxLength":200}},"required":["type"]},"MeasurementMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Measurement"],"description":"MetaField value type"},"units":{"$ref":"#/components/schemas/MeasurementUnits"},"value":{"type":"number","format":"double","description":"Measured value"}},"required":["type"]},"TimeMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Time"],"description":"MetaField value type"},"time":{"type":"integer","format":"int64","description":"Timestamp in milliseconds"}},"required":["type"]},"CoordinatesMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Coordinates"],"description":"MetaField value type"},"lat":{"type":"number","format":"double","description":"Latitude"},"lon":{"type":"number","format":"double","description":"Longitude"}},"required":["type"]},"AddressMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Address"],"description":"MetaField value type"},"streetAddress":{"type":"string","description":"Street address","maxLength":200},"city":{"type":"string","description":"City","maxLength":200},"state":{"type":"string","description":"State or province","maxLength":200},"zip":{"type":"string","description":"ZIP or postal code","maxLength":200},"country":{"type":"string","description":"Country","maxLength":200}},"required":["type"]},"ListMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["List"],"description":"MetaField value type"},"selectedOption":{"type":"string","description":"Currently selected option","maxLength":200}},"required":["type"]},"TableMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Table"],"description":"MetaField value type"},"selectedRowIndex":{"type":"integer","format":"int32","description":"Index of the selected row"}},"required":["type"]},"DeviceReferenceMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceReference"],"description":"MetaField value type"},"selectedDeviceId":{"type":"integer","format":"int32","description":"ID of the referenced device"}},"required":["type"]},"LocationMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Location"],"description":"MetaField value type"},"orgLocationId":{"type":"integer","format":"int32","description":"Organization location ID"},"siteName":{"type":"string","description":"Site name","maxLength":200},"lat":{"type":"number","format":"double","nullable":true,"description":"Latitude"},"lon":{"type":"number","format":"double","nullable":true,"description":"Longitude"},"buildingName":{"type":"string","description":"Building name","maxLength":200},"floorName":{"type":"string","description":"Floor name","maxLength":200},"unit":{"type":"string","description":"Unit identifier","maxLength":200},"room":{"type":"string","description":"Room identifier","maxLength":200},"zone":{"type":"string","description":"Zone identifier","maxLength":200},"size":{"type":"number","format":"double","description":"Size of the location"},"placeId":{"type":"string","description":"External place ID","maxLength":200},"mapStyle":{"type":"string","description":"Map display style","enum":["LIGHT","DARK","STREETS","OUTDOORS","SATELLITE","SATELLITE_STREETS","BLYNK_THEME"]}},"required":["type"]},"TzMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Tz"],"description":"MetaField value type"},"value":{"type":"string","description":"Timezone identifier","maxLength":200}},"required":["type"]},"ImageMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Image"],"description":"MetaField value type"},"url":{"type":"string","format":"uri","description":"Image URL","maxLength":200}},"required":["type"]},"DeviceNameMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceName"],"description":"MetaField value type"},"value":{"type":"string","description":"Device name"}},"required":["type"]},"DeviceOwnerMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceOwner"],"description":"MetaField value type"},"value":{"type":"string","format":"email","description":"Device owner email"},"userId":{"type":"integer","format":"int64","description":"Owner user ID"}},"required":["type"]},"HotspotNameMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["HotspotName"],"description":"MetaField value type"},"value":{"type":"string","description":"Hotspot name","maxLength":200}},"required":["type"]},"ImeiMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Imei"],"description":"MetaField value type"},"value":{"type":"string","description":"IMEI number"}},"required":["type"]},"ICCIDMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["ICCID"],"description":"MetaField value type"},"value":{"type":"string","description":"ICCID number","maxLength":200}},"required":["type"]},"DeviceEuiMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceEui"],"description":"MetaField value type"},"value":{"type":"string","description":"Device EUI (lowercase)","maxLength":200}},"required":["type"]},"JoinEuiMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["JoinEui"],"description":"MetaField value type"},"value":{"type":"string","description":"Join EUI (lowercase)","maxLength":200}},"required":["type"]},"ApplicationKeyMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["ApplicationKey"],"description":"MetaField value type"},"value":{"type":"string","description":"Application key","maxLength":200}},"required":["type"]},"BluesDeviceMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["BluesDevice"],"description":"MetaField value type"},"deviceId":{"type":"string","description":"Blues device ID","maxLength":200}},"required":["type"]},"TheThingsNetworkMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["TheThingsNetwork"],"description":"MetaField value type"},"deviceId":{"type":"string","description":"The Things Network device ID","maxLength":200}},"required":["type"]},"ThingNameMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["ThingName"],"description":"MetaField value type"},"region":{"type":"string","description":"AWS IoT region","enum":["us-east-2","us-east-1","us-west-1","us-west-2","ap-east-1","ap-south-1","ap-northeast-2","ap-southeast-1","ap-southeast-2","ap-northeast-1","ca-central-1","eu-central-1","eu-west-1","eu-west-2","eu-west-3","eu-north-1","me-south-1","me-central-1","sa-east-1"]},"thingName":{"type":"string","description":"AWS IoT thing name","maxLength":200}},"required":["type"]},"OTASettingsMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["OTASettings"],"description":"MetaField value type"},"isAutoupdateEnabled":{"type":"boolean","description":"Whether auto-update is enabled"}},"required":["type"]},"MyriotaTerminalIdMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["MyriotaTerminalId"],"description":"MetaField value type"},"terminalId":{"type":"string","description":"Myriota terminal ID","maxLength":200}},"required":["type"]}}}}
```

## The DeviceHardwareInfo object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceHardwareInfo":{"type":"object","properties":{"version":{"type":"string","description":"Device firmware version"},"fwType":{"type":"string","description":"Device firmware type"},"blynkVersion":{"type":"string","description":"Version of the Blynk Library, that is used on the device"},"boardType":{"$ref":"#/components/schemas/BoardType"},"build":{"type":"string","description":"Firmware build number, that is used on the device"},"templateId":{"type":"string","description":"The identifier of the template that the device belongs to."}}},"BoardType":{"type":"string","enum":["Arduino","BBC_Microbit","ESP32","ESP8266","Lantronix_Fox_3","Microduino","Onion_Omega","Particle","Pycom_WiPy","Raspberry_Pi","Seeed_Wio_Terminal","SparkFun_Blynk_Board","Teensy","TinyDuino","NodeRed","Python","TI_CC3220","Iridium","Iridium_9704_Launch_Pad","NCD","Milesight","Seeed","Blues","MOKOSmart","Thermokon","Miromiko","Pepperl_Fuchs","Atim","Other"],"description":"Device board type"}}}}
```

## The DeviceTag object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceTag":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Tag ID"},"name":{"type":"string","description":"Tag name"},"tagOwnerOrgId":{"type":"integer","format":"int32","description":"ID of the organization, that created the tag"}},"required":["id","name","tagOwnerOrgId"]}}}}
```

## The DataStreamValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DataStreamValue":{"type":"object","properties":{"dataStreamId":{"type":"integer","format":"int32","description":"DataStream ID"},"pin":{"type":"string","description":"DataStream pin"},"dataStreamLabel":{"type":"string","description":"DataStream label"},"dataStreamAlias":{"type":"string","description":"DataStream alias"},"value":{"$ref":"#/components/schemas/DataStreamRawValue"},"updatedAt":{"type":"integer","format":"int64","description":"Last update timestamp"}},"required":["dataStreamId","pin","dataStreamLabel","dataStreamAlias"]},"DataStreamRawValue":{"oneOf":[{"type":"string","description":"String datastream value"},{"type":"number","format":"double","description":"Double, integer or enum datastream value"},{"type":"array","description":"Location datastream value. Represented as an array of two elements, where the first is longitude, and the second is latitude.","items":{"type":"number","format":"double"},"minItems":2,"maxItems":2}]}}}}
```

## The DataStreamRawValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DataStreamRawValue":{"oneOf":[{"type":"string","description":"String datastream value"},{"type":"number","format":"double","description":"Double, integer or enum datastream value"},{"type":"array","description":"Location datastream value. Represented as an array of two elements, where the first is longitude, and the second is latitude.","items":{"type":"number","format":"double"},"minItems":2,"maxItems":2}]}}}}
```

## The DataStreamPropertyName object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DataStreamPropertyName":{"type":"string","enum":["label","color","onBackColor","offBackColor","onColor","offColor","onLabel","offLabel","labels","min","max","isOnPlay","url","urls","step","valueFormatting","suffix","maximumFractionDigits","opacity","scale","rotation","sortType","isDisabled","isHidden","icons","onImageUrl","offImageUrl","page","sound","isMuted","loop","autoplay","contentDesign","backColor"],"description":"Widget property to update"}}}}
```

## The MetaFieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"MetaFieldValue":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"MetaField ID"},"name":{"type":"string","description":"MetaField name"},"isMandatory":{"type":"boolean","description":"Mark whether the metafield is required"},"includeInProvision":{"type":"boolean","description":"Mark whether the metafield should be included in the provisioning flow"},"value":{"nullable":true,"description":"Metafield value. The schema depends on the `type` discriminator property.","discriminator":{"propertyName":"type","mapping":{"MultiText":"#/components/schemas/MultiTextMetafieldValue","Text":"#/components/schemas/TextMetafieldValue","Email":"#/components/schemas/EmailMetafieldValue","Number":"#/components/schemas/NumberMetafieldValue","Int":"#/components/schemas/IntMetafieldValue","Range":"#/components/schemas/RangeMetafieldValue","Shift":"#/components/schemas/ShiftMetafieldValue","Switch":"#/components/schemas/SwitchMetafieldValue","Cost":"#/components/schemas/CostMetafieldValue","Contact":"#/components/schemas/ContactMetafieldValue","Measurement":"#/components/schemas/MeasurementMetafieldValue","Time":"#/components/schemas/TimeMetafieldValue","Coordinates":"#/components/schemas/CoordinatesMetafieldValue","Address":"#/components/schemas/AddressMetafieldValue","List":"#/components/schemas/ListMetafieldValue","Table":"#/components/schemas/TableMetafieldValue","DeviceReference":"#/components/schemas/DeviceReferenceMetafieldValue","Location":"#/components/schemas/LocationMetafieldValue","Tz":"#/components/schemas/TzMetafieldValue","Image":"#/components/schemas/ImageMetafieldValue","DeviceName":"#/components/schemas/DeviceNameMetafieldValue","DeviceOwner":"#/components/schemas/DeviceOwnerMetafieldValue","HotspotName":"#/components/schemas/HotspotNameMetafieldValue","Imei":"#/components/schemas/ImeiMetafieldValue","ICCID":"#/components/schemas/ICCIDMetafieldValue","DeviceEui":"#/components/schemas/DeviceEuiMetafieldValue","JoinEui":"#/components/schemas/JoinEuiMetafieldValue","ApplicationKey":"#/components/schemas/ApplicationKeyMetafieldValue","BluesDevice":"#/components/schemas/BluesDeviceMetafieldValue","TheThingsNetwork":"#/components/schemas/TheThingsNetworkMetafieldValue","ThingName":"#/components/schemas/ThingNameMetafieldValue","OTASettings":"#/components/schemas/OTASettingsMetafieldValue","MyriotaTerminalId":"#/components/schemas/MyriotaTerminalIdMetafieldValue"}},"oneOf":[{"$ref":"#/components/schemas/MultiTextMetafieldValue"},{"$ref":"#/components/schemas/TextMetafieldValue"},{"$ref":"#/components/schemas/EmailMetafieldValue"},{"$ref":"#/components/schemas/NumberMetafieldValue"},{"$ref":"#/components/schemas/IntMetafieldValue"},{"$ref":"#/components/schemas/RangeMetafieldValue"},{"$ref":"#/components/schemas/ShiftMetafieldValue"},{"$ref":"#/components/schemas/SwitchMetafieldValue"},{"$ref":"#/components/schemas/CostMetafieldValue"},{"$ref":"#/components/schemas/ContactMetafieldValue"},{"$ref":"#/components/schemas/MeasurementMetafieldValue"},{"$ref":"#/components/schemas/TimeMetafieldValue"},{"$ref":"#/components/schemas/CoordinatesMetafieldValue"},{"$ref":"#/components/schemas/AddressMetafieldValue"},{"$ref":"#/components/schemas/ListMetafieldValue"},{"$ref":"#/components/schemas/TableMetafieldValue"},{"$ref":"#/components/schemas/DeviceReferenceMetafieldValue"},{"$ref":"#/components/schemas/LocationMetafieldValue"},{"$ref":"#/components/schemas/TzMetafieldValue"},{"$ref":"#/components/schemas/ImageMetafieldValue"},{"$ref":"#/components/schemas/DeviceNameMetafieldValue"},{"$ref":"#/components/schemas/DeviceOwnerMetafieldValue"},{"$ref":"#/components/schemas/HotspotNameMetafieldValue"},{"$ref":"#/components/schemas/ImeiMetafieldValue"},{"$ref":"#/components/schemas/ICCIDMetafieldValue"},{"$ref":"#/components/schemas/DeviceEuiMetafieldValue"},{"$ref":"#/components/schemas/JoinEuiMetafieldValue"},{"$ref":"#/components/schemas/ApplicationKeyMetafieldValue"},{"$ref":"#/components/schemas/BluesDeviceMetafieldValue"},{"$ref":"#/components/schemas/TheThingsNetworkMetafieldValue"},{"$ref":"#/components/schemas/ThingNameMetafieldValue"},{"$ref":"#/components/schemas/OTASettingsMetafieldValue"},{"$ref":"#/components/schemas/MyriotaTerminalIdMetafieldValue"}]}}},"MultiTextMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["MultiText"],"description":"MetaField value type"},"values":{"type":"array","items":{"type":"string","maxLength":200},"description":"List of text values","maxItems":10000}},"required":["type"]},"TextMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Text"],"description":"MetaField value type"},"value":{"type":"string","description":"Text value","maxLength":200}},"required":["type"]},"EmailMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Email"],"description":"MetaField value type"},"value":{"type":"string","format":"email","description":"Email address value","maxLength":255}},"required":["type"]},"NumberMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Number"],"description":"MetaField value type"},"value":{"type":"number","format":"double","description":"Numeric value"}},"required":["type","value"]},"IntMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Int"],"description":"MetaField value type"},"value":{"type":"integer","format":"int32","description":"Integer value"}},"required":["type","value"]},"RangeMetafieldValue":{"type":"object","description":"Time range value. `from` and `to` are represented as seconds since midnight (0–86399).","properties":{"type":{"type":"string","enum":["Range"],"description":"MetaField value type"},"from":{"type":"integer","format":"int32","description":"Start time as seconds since midnight"},"to":{"type":"integer","format":"int32","description":"End time as seconds since midnight"}},"required":["type"]},"ShiftMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Shift"],"description":"MetaField value type"},"shifts":{"type":"array","items":{"type":"object","description":"A named time range. `from` and `to` are represented as seconds since midnight (0–86399).","properties":{"name":{"type":"string","description":"Shift name","maxLength":200},"from":{"type":"integer","format":"int32","description":"Start time as seconds since midnight"},"to":{"type":"integer","format":"int32","description":"End time as seconds since midnight"}}},"maxItems":10000,"description":"List of shifts"}},"required":["type"]},"SwitchMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Switch"],"description":"MetaField value type"},"value":{"type":"string","description":"Currently selected switch option","maxLength":200},"from":{"type":"string","description":"Label for the \"off\" option","maxLength":200},"to":{"type":"string","description":"Label for the \"on\" option","maxLength":200}},"required":["type"]},"CostMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Cost"],"description":"MetaField value type"},"currency":{"type":"string","description":"ISO 4217 currency code"},"price":{"type":"number","format":"double","description":"Price value"},"perValue":{"type":"number","format":"double","description":"Per-unit value"},"units":{"$ref":"#/components/schemas/MeasurementUnits"}},"required":["type"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"ContactMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Contact"],"description":"MetaField value type"},"firstName":{"type":"string","description":"First name","maxLength":200},"lastName":{"type":"string","description":"Last name","maxLength":200},"email":{"type":"string","format":"email","description":"Email address","maxLength":255},"phone":{"type":"string","description":"Phone number","maxLength":200},"streetAddress":{"type":"string","description":"Street address line 1","maxLength":200},"streetAddress2":{"type":"string","description":"Street address line 2","maxLength":200},"country":{"type":"string","description":"Country","maxLength":200},"city":{"type":"string","description":"City","maxLength":200},"state":{"type":"string","description":"State or province","maxLength":200},"zip":{"type":"string","description":"ZIP or postal code","maxLength":200}},"required":["type"]},"MeasurementMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Measurement"],"description":"MetaField value type"},"units":{"$ref":"#/components/schemas/MeasurementUnits"},"value":{"type":"number","format":"double","description":"Measured value"}},"required":["type"]},"TimeMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Time"],"description":"MetaField value type"},"time":{"type":"integer","format":"int64","description":"Timestamp in milliseconds"}},"required":["type"]},"CoordinatesMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Coordinates"],"description":"MetaField value type"},"lat":{"type":"number","format":"double","description":"Latitude"},"lon":{"type":"number","format":"double","description":"Longitude"}},"required":["type"]},"AddressMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Address"],"description":"MetaField value type"},"streetAddress":{"type":"string","description":"Street address","maxLength":200},"city":{"type":"string","description":"City","maxLength":200},"state":{"type":"string","description":"State or province","maxLength":200},"zip":{"type":"string","description":"ZIP or postal code","maxLength":200},"country":{"type":"string","description":"Country","maxLength":200}},"required":["type"]},"ListMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["List"],"description":"MetaField value type"},"selectedOption":{"type":"string","description":"Currently selected option","maxLength":200}},"required":["type"]},"TableMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Table"],"description":"MetaField value type"},"selectedRowIndex":{"type":"integer","format":"int32","description":"Index of the selected row"}},"required":["type"]},"DeviceReferenceMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceReference"],"description":"MetaField value type"},"selectedDeviceId":{"type":"integer","format":"int32","description":"ID of the referenced device"}},"required":["type"]},"LocationMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Location"],"description":"MetaField value type"},"orgLocationId":{"type":"integer","format":"int32","description":"Organization location ID"},"siteName":{"type":"string","description":"Site name","maxLength":200},"lat":{"type":"number","format":"double","nullable":true,"description":"Latitude"},"lon":{"type":"number","format":"double","nullable":true,"description":"Longitude"},"buildingName":{"type":"string","description":"Building name","maxLength":200},"floorName":{"type":"string","description":"Floor name","maxLength":200},"unit":{"type":"string","description":"Unit identifier","maxLength":200},"room":{"type":"string","description":"Room identifier","maxLength":200},"zone":{"type":"string","description":"Zone identifier","maxLength":200},"size":{"type":"number","format":"double","description":"Size of the location"},"placeId":{"type":"string","description":"External place ID","maxLength":200},"mapStyle":{"type":"string","description":"Map display style","enum":["LIGHT","DARK","STREETS","OUTDOORS","SATELLITE","SATELLITE_STREETS","BLYNK_THEME"]}},"required":["type"]},"TzMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Tz"],"description":"MetaField value type"},"value":{"type":"string","description":"Timezone identifier","maxLength":200}},"required":["type"]},"ImageMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Image"],"description":"MetaField value type"},"url":{"type":"string","format":"uri","description":"Image URL","maxLength":200}},"required":["type"]},"DeviceNameMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceName"],"description":"MetaField value type"},"value":{"type":"string","description":"Device name"}},"required":["type"]},"DeviceOwnerMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceOwner"],"description":"MetaField value type"},"value":{"type":"string","format":"email","description":"Device owner email"},"userId":{"type":"integer","format":"int64","description":"Owner user ID"}},"required":["type"]},"HotspotNameMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["HotspotName"],"description":"MetaField value type"},"value":{"type":"string","description":"Hotspot name","maxLength":200}},"required":["type"]},"ImeiMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Imei"],"description":"MetaField value type"},"value":{"type":"string","description":"IMEI number"}},"required":["type"]},"ICCIDMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["ICCID"],"description":"MetaField value type"},"value":{"type":"string","description":"ICCID number","maxLength":200}},"required":["type"]},"DeviceEuiMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceEui"],"description":"MetaField value type"},"value":{"type":"string","description":"Device EUI (lowercase)","maxLength":200}},"required":["type"]},"JoinEuiMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["JoinEui"],"description":"MetaField value type"},"value":{"type":"string","description":"Join EUI (lowercase)","maxLength":200}},"required":["type"]},"ApplicationKeyMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["ApplicationKey"],"description":"MetaField value type"},"value":{"type":"string","description":"Application key","maxLength":200}},"required":["type"]},"BluesDeviceMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["BluesDevice"],"description":"MetaField value type"},"deviceId":{"type":"string","description":"Blues device ID","maxLength":200}},"required":["type"]},"TheThingsNetworkMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["TheThingsNetwork"],"description":"MetaField value type"},"deviceId":{"type":"string","description":"The Things Network device ID","maxLength":200}},"required":["type"]},"ThingNameMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["ThingName"],"description":"MetaField value type"},"region":{"type":"string","description":"AWS IoT region","enum":["us-east-2","us-east-1","us-west-1","us-west-2","ap-east-1","ap-south-1","ap-northeast-2","ap-southeast-1","ap-southeast-2","ap-northeast-1","ca-central-1","eu-central-1","eu-west-1","eu-west-2","eu-west-3","eu-north-1","me-south-1","me-central-1","sa-east-1"]},"thingName":{"type":"string","description":"AWS IoT thing name","maxLength":200}},"required":["type"]},"OTASettingsMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["OTASettings"],"description":"MetaField value type"},"isAutoupdateEnabled":{"type":"boolean","description":"Whether auto-update is enabled"}},"required":["type"]},"MyriotaTerminalIdMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["MyriotaTerminalId"],"description":"MetaField value type"},"terminalId":{"type":"string","description":"Myriota terminal ID","maxLength":200}},"required":["type"]}}}}
```

## The Permission object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"Permission":{"type":"string","description":"User permission name that grants access to specific features and operations","enum":["ALLOW_FORCE_USER_LOGOUT","ASSIGN_TAG","AUTHENTICATE_TO_MCP","AUTOMATION_CREATE","AUTOMATION_DELETE","AUTOMATION_EDIT","AUTOMATION_EXECUTE","AUTOMATION_VIEW","BILLING","CHANGE_DEV_MODE","CHANGE_USER_PASSWORD","EDIT_DEVICE_SEGMENTS","EDIT_TIMELINE","ENABLE_OFFLINE_AUTOMATION","EXPORT_SEARCH_DEVICES","EXPORT_SEARCH_ORGS","EXPORT_SEARCH_USERS","MANAGE_ASSETS","MANAGE_AUTOMATION_TEMPLATES","MANAGE_AWS_IOT_INTEGRATION","MANAGE_BLUEPRINTS","MANAGE_BLUES_INTEGRATION","MANAGE_CHIRPSTACK_INTEGRATION","MANAGE_COLUMNS","MANAGE_CUSTOM_DATA_TABLE","MANAGE_DEMAND_RESPONSE","MANAGE_EVENTS_ANALYTICS","MANAGE_FORMS","MANAGE_IN_APP_CAMPAIGN","MANAGE_MYRIOTA_INTEGRATION","MANAGE_OPEN_WEATHER_INTEGRATION","MANAGE_ORDERS","MANAGE_SHARING","MANAGE_STATIC_TOKENS","MANAGE_STREAMING","MANAGE_TAG","MANAGE_TOURS","MANAGE_TTN_INTEGRATION","MANAGE_WEB_HOOK","OAUTH_TOKEN_CREATE","OAUTH_TOKEN_DELETE","OAUTH_TOKEN_EDIT","OAUTH_TOKEN_VIEW","ORG_ANALYTICS_CREATE","ORG_ANALYTICS_DELETE","ORG_ANALYTICS_EDIT","ORG_ANALYTICS_VIEW","ORG_CREATE","ORG_DELETE","ORG_DELETE_USERS","ORG_DEVICES_CONTROL","ORG_DEVICES_CREATE","ORG_DEVICES_DELETE","ORG_DEVICES_EDIT","ORG_DEVICES_VIEW","ORG_DEVICE_DATA_DELETE","ORG_DEVICE_DATA_EXPORT","ORG_DEVICE_DATA_IMPORT","ORG_DEVICE_VIEW_ACTION_LOG","ORG_EDIT","ORG_EDIT_USERS","ORG_INVITE_USERS","ORG_LOCATION_ASSIGN","ORG_LOCATION_CREATE","ORG_LOCATION_DELETE","ORG_LOCATION_EDIT","ORG_LOCATION_VIEW","ORG_SMS_SETTINGS_UPDATE","ORG_SWITCH","ORG_VIEW","ORG_VIEW_USERS","OTA_CANCEL","OTA_START","OTA_VIEW","OWN_DEVICES_CONTROL","OWN_DEVICES_DELETE","OWN_DEVICES_EDIT","OWN_DEVICES_VIEW","OWN_DEVICE_DATA_DELETE","OWN_DEVICE_DATA_EXPORT","OWN_DEVICE_DATA_IMPORT","OWN_DEVICE_VIEW_ACTION_LOG","OWN_LOCATION_ASSIGN","OWN_LOCATION_DELETE","OWN_LOCATION_EDIT","OWN_LOCATION_VIEW","OWN_ORG_EDIT","PRODUCT_CREATE","PRODUCT_DELETE","PRODUCT_EDIT","PRODUCT_VIEW","PROVISION_DEVICES","PUBLISH_BLUEPRINT","ROLE_CREATE","ROLE_DELETE","ROLE_EDIT","ROLE_VIEW","RULE_CREATE","RULE_DELETE","RULE_EDIT","RULE_VIEW","SET_AUTH_TOKEN","SKIP_FIRMWARE_TYPE_CHECK_OTA","SUSPEND_USER","TEMPLATE_VOICE_ASSISTANCE","TRANSFER_DEVICE","TRANSFER_ORG","TRANSFER_USER","USER_TRANSLATION_CRUD","VIEW_CUSTOM_DATA_TABLES","VIEW_DEVICE_DATA_SNAPSHOTS","VIEW_DEVICE_SEGMENTS","VIEW_FORMS","VIEW_HIERARCHY_TAG","VIEW_ORDERS","VIEW_OWN_ORG_TAG","VIEW_OWN_TAG","VIEW_THEME","VIEW_TIMELINE","VIEW_USER_ACTION_LOG"]}}}}
```

## The User object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"User":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"User ID"},"name":{"type":"string","description":"User name"},"email":{"type":"string","format":"email","description":"User email"},"roleId":{"type":"integer","format":"int32","description":"User role ID"},"orgId":{"type":"integer","format":"int32","description":"Organization ID, that the user belongs to"},"isDev":{"type":"boolean","description":"Whether the user has enabled the developer mode"}},"required":["id","roleId","orgId","isDev"]}}}}
```

## The UserDetails object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"UserDetails":{"allOf":[{"$ref":"#/components/schemas/User"},{"type":"object","properties":{"title":{"type":"string","description":"User title"},"nickName":{"type":"string","description":"User nickname"},"phoneNumber":{"type":"string","description":"User phone number"},"tz":{"type":"string","description":"User timezone in the IANA Time Zone Database (TZDB) format."},"locale":{"type":"string","description":"User locale."},"status":{"type":"string","enum":["Pending","Active","Inactive","Suspended"],"description":"User status"},"lastModifiedTs":{"type":"integer","format":"int64","description":"Timestamp, indicating the time, when the user was modified last time (Unix epoch milliseconds)"},"lastLoggedAt":{"type":"integer","format":"int64","description":"Timestamp, when the user has logged in last time (Unix epoch milliseconds)"},"registeredAt":{"type":"integer","format":"int64","description":"Timestamp, when the user has registered (Unix epoch milliseconds)"}},"required":["id","email","roleId","orgId","status","lastModifiedTs","registeredAt","isDev"]}]},"User":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"User ID"},"name":{"type":"string","description":"User name"},"email":{"type":"string","format":"email","description":"User email"},"roleId":{"type":"integer","format":"int32","description":"User role ID"},"orgId":{"type":"integer","format":"int32","description":"Organization ID, that the user belongs to"},"isDev":{"type":"boolean","description":"Whether the user has enabled the developer mode"}},"required":["id","roleId","orgId","isDev"]}}}}
```

## The UserProfile object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"UserProfile":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"User ID"},"name":{"type":"string","description":"User name"},"email":{"type":"string","format":"email","description":"User email"},"title":{"type":"string","description":"User title"},"nickName":{"type":"string","description":"User nickname"},"phoneNumber":{"type":"string","description":"User phone number"},"role":{"type":"object","description":"User role information","required":["id","name","permissions"],"properties":{"id":{"type":"integer","format":"int32","description":"Role ID"},"name":{"type":"string","description":"Role name"},"permissions":{"type":"array","items":{"$ref":"#/components/schemas/Permission"},"description":"Array of permission names"}}},"orgId":{"type":"integer","format":"int32","description":"Organization ID, that the user belongs to"},"orgName":{"type":"string","description":"Organization name"},"tz":{"type":"string","description":"User timezone in the IANA Time Zone Database (TZDB) format."},"locale":{"type":"string","description":"User locale."},"status":{"type":"string","enum":["Pending","Active","Inactive","Suspended"],"description":"User status"},"lastModifiedTs":{"type":"integer","format":"int64","description":"Timestamp, indicating the time, when the user was modified last time (Unix epoch milliseconds)"},"lastLoggedAt":{"type":"integer","format":"int64","description":"Timestamp, when the user has logged in last time (Unix epoch milliseconds)"},"registeredAt":{"type":"integer","format":"int64","description":"Timestamp, when the user has registered (Unix epoch milliseconds)"},"isDev":{"type":"boolean","description":"Whether the user has enabled the developer mode"},"isDarkMode":{"type":"boolean","description":"Whether the user has enabled dark mode"}},"required":["id","email","role","orgId","status","lastModifiedTs","registeredAt","isDev","isDarkMode"]},"Permission":{"type":"string","description":"User permission name that grants access to specific features and operations","enum":["ALLOW_FORCE_USER_LOGOUT","ASSIGN_TAG","AUTHENTICATE_TO_MCP","AUTOMATION_CREATE","AUTOMATION_DELETE","AUTOMATION_EDIT","AUTOMATION_EXECUTE","AUTOMATION_VIEW","BILLING","CHANGE_DEV_MODE","CHANGE_USER_PASSWORD","EDIT_DEVICE_SEGMENTS","EDIT_TIMELINE","ENABLE_OFFLINE_AUTOMATION","EXPORT_SEARCH_DEVICES","EXPORT_SEARCH_ORGS","EXPORT_SEARCH_USERS","MANAGE_ASSETS","MANAGE_AUTOMATION_TEMPLATES","MANAGE_AWS_IOT_INTEGRATION","MANAGE_BLUEPRINTS","MANAGE_BLUES_INTEGRATION","MANAGE_CHIRPSTACK_INTEGRATION","MANAGE_COLUMNS","MANAGE_CUSTOM_DATA_TABLE","MANAGE_DEMAND_RESPONSE","MANAGE_EVENTS_ANALYTICS","MANAGE_FORMS","MANAGE_IN_APP_CAMPAIGN","MANAGE_MYRIOTA_INTEGRATION","MANAGE_OPEN_WEATHER_INTEGRATION","MANAGE_ORDERS","MANAGE_SHARING","MANAGE_STATIC_TOKENS","MANAGE_STREAMING","MANAGE_TAG","MANAGE_TOURS","MANAGE_TTN_INTEGRATION","MANAGE_WEB_HOOK","OAUTH_TOKEN_CREATE","OAUTH_TOKEN_DELETE","OAUTH_TOKEN_EDIT","OAUTH_TOKEN_VIEW","ORG_ANALYTICS_CREATE","ORG_ANALYTICS_DELETE","ORG_ANALYTICS_EDIT","ORG_ANALYTICS_VIEW","ORG_CREATE","ORG_DELETE","ORG_DELETE_USERS","ORG_DEVICES_CONTROL","ORG_DEVICES_CREATE","ORG_DEVICES_DELETE","ORG_DEVICES_EDIT","ORG_DEVICES_VIEW","ORG_DEVICE_DATA_DELETE","ORG_DEVICE_DATA_EXPORT","ORG_DEVICE_DATA_IMPORT","ORG_DEVICE_VIEW_ACTION_LOG","ORG_EDIT","ORG_EDIT_USERS","ORG_INVITE_USERS","ORG_LOCATION_ASSIGN","ORG_LOCATION_CREATE","ORG_LOCATION_DELETE","ORG_LOCATION_EDIT","ORG_LOCATION_VIEW","ORG_SMS_SETTINGS_UPDATE","ORG_SWITCH","ORG_VIEW","ORG_VIEW_USERS","OTA_CANCEL","OTA_START","OTA_VIEW","OWN_DEVICES_CONTROL","OWN_DEVICES_DELETE","OWN_DEVICES_EDIT","OWN_DEVICES_VIEW","OWN_DEVICE_DATA_DELETE","OWN_DEVICE_DATA_EXPORT","OWN_DEVICE_DATA_IMPORT","OWN_DEVICE_VIEW_ACTION_LOG","OWN_LOCATION_ASSIGN","OWN_LOCATION_DELETE","OWN_LOCATION_EDIT","OWN_LOCATION_VIEW","OWN_ORG_EDIT","PRODUCT_CREATE","PRODUCT_DELETE","PRODUCT_EDIT","PRODUCT_VIEW","PROVISION_DEVICES","PUBLISH_BLUEPRINT","ROLE_CREATE","ROLE_DELETE","ROLE_EDIT","ROLE_VIEW","RULE_CREATE","RULE_DELETE","RULE_EDIT","RULE_VIEW","SET_AUTH_TOKEN","SKIP_FIRMWARE_TYPE_CHECK_OTA","SUSPEND_USER","TEMPLATE_VOICE_ASSISTANCE","TRANSFER_DEVICE","TRANSFER_ORG","TRANSFER_USER","USER_TRANSLATION_CRUD","VIEW_CUSTOM_DATA_TABLES","VIEW_DEVICE_DATA_SNAPSHOTS","VIEW_DEVICE_SEGMENTS","VIEW_FORMS","VIEW_HIERARCHY_TAG","VIEW_ORDERS","VIEW_OWN_ORG_TAG","VIEW_OWN_TAG","VIEW_THEME","VIEW_TIMELINE","VIEW_USER_ACTION_LOG"]}}}}
```

## The Address object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"Address":{"type":"object","properties":{"fullAddress":{"type":"string","maxLength":512,"description":"Full address"},"country":{"type":"string","maxLength":74,"description":"Country name"},"city":{"type":"string","maxLength":50,"description":"City name"},"state":{"type":"string","maxLength":40,"description":"State or province"},"zip":{"type":"string","maxLength":12,"description":"Postal code"}}}}}}
```

## The Template object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"Template":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Template ID"},"templateIds":{"type":"array","items":{"type":"string"},"description":"List of template IDs, that are used on the device"},"parentId":{"type":"integer","format":"int32","description":"Parent template ID"},"orgId":{"type":"integer","format":"int32","description":"Organization ID, that the template belongs to"},"name":{"type":"string","description":"Template name"}},"required":["id","templateIds","orgId","name"]}}}}
```

## The TemplateDetails object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"TemplateDetails":{"allOf":[{"$ref":"#/components/schemas/Template"},{"type":"object","properties":{"boardType":{"$ref":"#/components/schemas/BoardType"},"connectionType":{"$ref":"#/components/schemas/ConnectionType"},"description":{"type":"string","description":"Template description"},"logoUrl":{"type":"string","description":"path of the template logo image, that should be prefixed with the server URL"},"createdAt":{"type":"integer","format":"int64","description":"Template creation timestamp"}},"required":["id","templateIds","orgId","name","createdAt"]}]},"Template":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Template ID"},"templateIds":{"type":"array","items":{"type":"string"},"description":"List of template IDs, that are used on the device"},"parentId":{"type":"integer","format":"int32","description":"Parent template ID"},"orgId":{"type":"integer","format":"int32","description":"Organization ID, that the template belongs to"},"name":{"type":"string","description":"Template name"}},"required":["id","templateIds","orgId","name"]},"BoardType":{"type":"string","enum":["Arduino","BBC_Microbit","ESP32","ESP8266","Lantronix_Fox_3","Microduino","Onion_Omega","Particle","Pycom_WiPy","Raspberry_Pi","Seeed_Wio_Terminal","SparkFun_Blynk_Board","Teensy","TinyDuino","NodeRed","Python","TI_CC3220","Iridium","Iridium_9704_Launch_Pad","NCD","Milesight","Seeed","Blues","MOKOSmart","Thermokon","Miromiko","Pepperl_Fuchs","Atim","Other"],"description":"Device board type"},"ConnectionType":{"type":"string","enum":["ETHERNET","WI_FI","USB","BLUETOOTH","BLE","GSM","SATELLITE","LORAWAN"],"description":"Connection type, that is used on the device"}}}}
```

## The TemplateDataStream object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"TemplateDataStream":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"DataStream ID"},"label":{"type":"string","description":"DataStream label"},"alias":{"type":"string","description":"DataStream alias"},"units":{"$ref":"#/components/schemas/MeasurementUnits"},"type":{"type":"string","enum":["STRING","INT","DOUBLE","BOOLEAN","LOCATION","ENUM"],"description":"DataStream value type"},"defaultValue":{"$ref":"#/components/schemas/DataStreamRawValue"},"pin":{"type":"integer","format":"int32","description":"Virtual pin number"},"pinType":{"type":"string","enum":["VIRTUAL","DIGITAL","ANALOG"],"description":"Pin type"},"pinMode":{"type":"string","enum":["INPUT","OUTPUT","INPUT_PULL_UP","INPUT_PULL_DOWN"],"description":"Pin mode"},"isAnalogPin":{"type":"boolean","description":"Whether the pin is an analog pin"},"isRaw":{"type":"boolean","description":"Whether the datastream value should be stored as raw value without parsing"},"isHistory":{"type":"boolean","description":"Whether the datastream should be stored in the aggregated format"},"isForService":{"type":"boolean","description":"Whether the datastream should be displayed in the service chart widget"},"isForReports":{"type":"boolean","description":"Whether the datastream is used for reporting purposes"},"isForActions":{"type":"boolean","description":"Whether the datastream can be used in the automation actions"},"isForConditions":{"type":"boolean","description":"Whether the datastream can be used in the automation conditions"},"isSync":{"type":"boolean","description":"Whether the datastream value should be synced on the hardware request"},"min":{"type":"number","format":"double","description":"Minimum allowed datastream value"},"max":{"type":"number","format":"double","description":"Maximum allowed datastream value"}},"required":["id","label","alias","type","pin","pinType","isAnalogPin","isRaw","isHistory","isForService","isForReports","isForActions","isForConditions","isSync"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"DataStreamRawValue":{"oneOf":[{"type":"string","description":"String datastream value"},{"type":"number","format":"double","description":"Double, integer or enum datastream value"},{"type":"array","description":"Location datastream value. Represented as an array of two elements, where the first is longitude, and the second is latitude.","items":{"type":"number","format":"double"},"minItems":2,"maxItems":2}]}}}}
```

## The DataStreamDataType object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DataStreamDataType":{"type":"object","discriminator":{"propertyName":"type","mapping":{"STRING":"#/components/schemas/DataStreamStringDataType","INT":"#/components/schemas/DataStreamIntDataType","DOUBLE":"#/components/schemas/DataStreamDoubleDataType","ENUM":"#/components/schemas/DataStreamEnumDataType","LOCATION":"#/components/schemas/DataStreamLocationDataType"}},"oneOf":[{"$ref":"#/components/schemas/DataStreamStringDataType"},{"$ref":"#/components/schemas/DataStreamIntDataType"},{"$ref":"#/components/schemas/DataStreamDoubleDataType"},{"$ref":"#/components/schemas/DataStreamEnumDataType"},{"$ref":"#/components/schemas/DataStreamLocationDataType"}]},"DataStreamStringDataType":{"type":"object","properties":{"type":{"type":"string","enum":["STRING"],"description":"DataStream value type"},"defaultValue":{"type":"string","description":"Default value for the datastream"}},"required":["type"]},"DataStreamIntDataType":{"type":"object","properties":{"type":{"type":"string","enum":["INT"],"description":"DataStream value type"},"defaultValue":{"type":"integer","format":"int32","description":"Default value for the datastream"},"min":{"type":"integer","format":"int32","description":"Minimum value for the datastream"},"max":{"type":"integer","format":"int32","description":"Maximum value for the datastream"}},"required":["type","min","max"]},"DataStreamDoubleDataType":{"type":"object","properties":{"type":{"type":"string","enum":["DOUBLE"],"description":"DataStream value type"},"defaultValue":{"type":"number","format":"double","description":"Default value for the datastream"},"min":{"type":"number","format":"double","description":"Minimum value for the datastream"},"max":{"type":"number","format":"double","description":"Maximum value for the datastream"},"decimalsFormat":{"type":"string","description":"Decimal format for the datastream value, that is used for displaying the value in the dashboard and reports.","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]}},"required":["type","min","max","decimalsFormat"]},"DataStreamEnumDataType":{"type":"object","properties":{"type":{"type":"string","enum":["ENUM"],"description":"DataStream value type"},"defaultValue":{"type":"integer","format":"int32","description":"Default value for the datastream"}},"required":["type"]},"DataStreamLocationDataType":{"type":"object","properties":{"type":{"type":"string","enum":["LOCATION"],"description":"DataStream value type"},"defaultValue":{"type":"string","description":"Default value for the datastream. Should be in format 'longitude,latitude'"}},"required":["type"]}}}}
```

## The DataStreamStringDataType object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DataStreamStringDataType":{"type":"object","properties":{"type":{"type":"string","enum":["STRING"],"description":"DataStream value type"},"defaultValue":{"type":"string","description":"Default value for the datastream"}},"required":["type"]}}}}
```

## The DataStreamIntDataType object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DataStreamIntDataType":{"type":"object","properties":{"type":{"type":"string","enum":["INT"],"description":"DataStream value type"},"defaultValue":{"type":"integer","format":"int32","description":"Default value for the datastream"},"min":{"type":"integer","format":"int32","description":"Minimum value for the datastream"},"max":{"type":"integer","format":"int32","description":"Maximum value for the datastream"}},"required":["type","min","max"]}}}}
```

## The DataStreamDoubleDataType object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DataStreamDoubleDataType":{"type":"object","properties":{"type":{"type":"string","enum":["DOUBLE"],"description":"DataStream value type"},"defaultValue":{"type":"number","format":"double","description":"Default value for the datastream"},"min":{"type":"number","format":"double","description":"Minimum value for the datastream"},"max":{"type":"number","format":"double","description":"Maximum value for the datastream"},"decimalsFormat":{"type":"string","description":"Decimal format for the datastream value, that is used for displaying the value in the dashboard and reports.","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]}},"required":["type","min","max","decimalsFormat"]}}}}
```

## The DataStreamEnumDataType object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DataStreamEnumDataType":{"type":"object","properties":{"type":{"type":"string","enum":["ENUM"],"description":"DataStream value type"},"defaultValue":{"type":"integer","format":"int32","description":"Default value for the datastream"}},"required":["type"]}}}}
```

## The DataStreamLocationDataType object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DataStreamLocationDataType":{"type":"object","properties":{"type":{"type":"string","enum":["LOCATION"],"description":"DataStream value type"},"defaultValue":{"type":"string","description":"Default value for the datastream. Should be in format 'longitude,latitude'"}},"required":["type"]}}}}
```

## The MeasurementUnits object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]}}}}
```

## The MultiTextMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"MultiTextMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["MultiText"],"description":"MetaField value type"},"values":{"type":"array","items":{"type":"string","maxLength":200},"description":"List of text values","maxItems":10000}},"required":["type"]}}}}
```

## The TextMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"TextMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Text"],"description":"MetaField value type"},"value":{"type":"string","description":"Text value","maxLength":200}},"required":["type"]}}}}
```

## The EmailMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"EmailMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Email"],"description":"MetaField value type"},"value":{"type":"string","format":"email","description":"Email address value","maxLength":255}},"required":["type"]}}}}
```

## The NumberMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"NumberMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Number"],"description":"MetaField value type"},"value":{"type":"number","format":"double","description":"Numeric value"}},"required":["type","value"]}}}}
```

## The IntMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"IntMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Int"],"description":"MetaField value type"},"value":{"type":"integer","format":"int32","description":"Integer value"}},"required":["type","value"]}}}}
```

## The RangeMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"RangeMetafieldValue":{"type":"object","description":"Time range value. `from` and `to` are represented as seconds since midnight (0–86399).","properties":{"type":{"type":"string","enum":["Range"],"description":"MetaField value type"},"from":{"type":"integer","format":"int32","description":"Start time as seconds since midnight"},"to":{"type":"integer","format":"int32","description":"End time as seconds since midnight"}},"required":["type"]}}}}
```

## The ShiftMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ShiftMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Shift"],"description":"MetaField value type"},"shifts":{"type":"array","items":{"type":"object","description":"A named time range. `from` and `to` are represented as seconds since midnight (0–86399).","properties":{"name":{"type":"string","description":"Shift name","maxLength":200},"from":{"type":"integer","format":"int32","description":"Start time as seconds since midnight"},"to":{"type":"integer","format":"int32","description":"End time as seconds since midnight"}}},"maxItems":10000,"description":"List of shifts"}},"required":["type"]}}}}
```

## The SwitchMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"SwitchMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Switch"],"description":"MetaField value type"},"value":{"type":"string","description":"Currently selected switch option","maxLength":200},"from":{"type":"string","description":"Label for the \"off\" option","maxLength":200},"to":{"type":"string","description":"Label for the \"on\" option","maxLength":200}},"required":["type"]}}}}
```

## The CostMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"CostMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Cost"],"description":"MetaField value type"},"currency":{"type":"string","description":"ISO 4217 currency code"},"price":{"type":"number","format":"double","description":"Price value"},"perValue":{"type":"number","format":"double","description":"Per-unit value"},"units":{"$ref":"#/components/schemas/MeasurementUnits"}},"required":["type"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]}}}}
```

## The ContactMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ContactMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Contact"],"description":"MetaField value type"},"firstName":{"type":"string","description":"First name","maxLength":200},"lastName":{"type":"string","description":"Last name","maxLength":200},"email":{"type":"string","format":"email","description":"Email address","maxLength":255},"phone":{"type":"string","description":"Phone number","maxLength":200},"streetAddress":{"type":"string","description":"Street address line 1","maxLength":200},"streetAddress2":{"type":"string","description":"Street address line 2","maxLength":200},"country":{"type":"string","description":"Country","maxLength":200},"city":{"type":"string","description":"City","maxLength":200},"state":{"type":"string","description":"State or province","maxLength":200},"zip":{"type":"string","description":"ZIP or postal code","maxLength":200}},"required":["type"]}}}}
```

## The MeasurementMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"MeasurementMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Measurement"],"description":"MetaField value type"},"units":{"$ref":"#/components/schemas/MeasurementUnits"},"value":{"type":"number","format":"double","description":"Measured value"}},"required":["type"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]}}}}
```

## The TimeMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"TimeMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Time"],"description":"MetaField value type"},"time":{"type":"integer","format":"int64","description":"Timestamp in milliseconds"}},"required":["type"]}}}}
```

## The CoordinatesMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"CoordinatesMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Coordinates"],"description":"MetaField value type"},"lat":{"type":"number","format":"double","description":"Latitude"},"lon":{"type":"number","format":"double","description":"Longitude"}},"required":["type"]}}}}
```

## The AddressMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"AddressMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Address"],"description":"MetaField value type"},"streetAddress":{"type":"string","description":"Street address","maxLength":200},"city":{"type":"string","description":"City","maxLength":200},"state":{"type":"string","description":"State or province","maxLength":200},"zip":{"type":"string","description":"ZIP or postal code","maxLength":200},"country":{"type":"string","description":"Country","maxLength":200}},"required":["type"]}}}}
```

## The ListMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ListMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["List"],"description":"MetaField value type"},"selectedOption":{"type":"string","description":"Currently selected option","maxLength":200}},"required":["type"]}}}}
```

## The TableMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"TableMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Table"],"description":"MetaField value type"},"selectedRowIndex":{"type":"integer","format":"int32","description":"Index of the selected row"}},"required":["type"]}}}}
```

## The DeviceReferenceMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceReferenceMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceReference"],"description":"MetaField value type"},"selectedDeviceId":{"type":"integer","format":"int32","description":"ID of the referenced device"}},"required":["type"]}}}}
```

## The LocationMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"LocationMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Location"],"description":"MetaField value type"},"orgLocationId":{"type":"integer","format":"int32","description":"Organization location ID"},"siteName":{"type":"string","description":"Site name","maxLength":200},"lat":{"type":"number","format":"double","nullable":true,"description":"Latitude"},"lon":{"type":"number","format":"double","nullable":true,"description":"Longitude"},"buildingName":{"type":"string","description":"Building name","maxLength":200},"floorName":{"type":"string","description":"Floor name","maxLength":200},"unit":{"type":"string","description":"Unit identifier","maxLength":200},"room":{"type":"string","description":"Room identifier","maxLength":200},"zone":{"type":"string","description":"Zone identifier","maxLength":200},"size":{"type":"number","format":"double","description":"Size of the location"},"placeId":{"type":"string","description":"External place ID","maxLength":200},"mapStyle":{"type":"string","description":"Map display style","enum":["LIGHT","DARK","STREETS","OUTDOORS","SATELLITE","SATELLITE_STREETS","BLYNK_THEME"]}},"required":["type"]}}}}
```

## The TzMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"TzMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Tz"],"description":"MetaField value type"},"value":{"type":"string","description":"Timezone identifier","maxLength":200}},"required":["type"]}}}}
```

## The ImageMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ImageMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Image"],"description":"MetaField value type"},"url":{"type":"string","format":"uri","description":"Image URL","maxLength":200}},"required":["type"]}}}}
```

## The DeviceNameMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceNameMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceName"],"description":"MetaField value type"},"value":{"type":"string","description":"Device name"}},"required":["type"]}}}}
```

## The DeviceOwnerMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceOwnerMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceOwner"],"description":"MetaField value type"},"value":{"type":"string","format":"email","description":"Device owner email"},"userId":{"type":"integer","format":"int64","description":"Owner user ID"}},"required":["type"]}}}}
```

## The HotspotNameMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"HotspotNameMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["HotspotName"],"description":"MetaField value type"},"value":{"type":"string","description":"Hotspot name","maxLength":200}},"required":["type"]}}}}
```

## The ImeiMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ImeiMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["Imei"],"description":"MetaField value type"},"value":{"type":"string","description":"IMEI number"}},"required":["type"]}}}}
```

## The ICCIDMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ICCIDMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["ICCID"],"description":"MetaField value type"},"value":{"type":"string","description":"ICCID number","maxLength":200}},"required":["type"]}}}}
```

## The DeviceEuiMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceEuiMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["DeviceEui"],"description":"MetaField value type"},"value":{"type":"string","description":"Device EUI (lowercase)","maxLength":200}},"required":["type"]}}}}
```

## The JoinEuiMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"JoinEuiMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["JoinEui"],"description":"MetaField value type"},"value":{"type":"string","description":"Join EUI (lowercase)","maxLength":200}},"required":["type"]}}}}
```

## The ApplicationKeyMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ApplicationKeyMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["ApplicationKey"],"description":"MetaField value type"},"value":{"type":"string","description":"Application key","maxLength":200}},"required":["type"]}}}}
```

## The BluesDeviceMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"BluesDeviceMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["BluesDevice"],"description":"MetaField value type"},"deviceId":{"type":"string","description":"Blues device ID","maxLength":200}},"required":["type"]}}}}
```

## The TheThingsNetworkMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"TheThingsNetworkMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["TheThingsNetwork"],"description":"MetaField value type"},"deviceId":{"type":"string","description":"The Things Network device ID","maxLength":200}},"required":["type"]}}}}
```

## The ThingNameMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ThingNameMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["ThingName"],"description":"MetaField value type"},"region":{"type":"string","description":"AWS IoT region","enum":["us-east-2","us-east-1","us-west-1","us-west-2","ap-east-1","ap-south-1","ap-northeast-2","ap-southeast-1","ap-southeast-2","ap-northeast-1","ca-central-1","eu-central-1","eu-west-1","eu-west-2","eu-west-3","eu-north-1","me-south-1","me-central-1","sa-east-1"]},"thingName":{"type":"string","description":"AWS IoT thing name","maxLength":200}},"required":["type"]}}}}
```

## The OTASettingsMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"OTASettingsMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["OTASettings"],"description":"MetaField value type"},"isAutoupdateEnabled":{"type":"boolean","description":"Whether auto-update is enabled"}},"required":["type"]}}}}
```

## The MyriotaTerminalIdMetafieldValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"MyriotaTerminalIdMetafieldValue":{"type":"object","properties":{"type":{"type":"string","enum":["MyriotaTerminalId"],"description":"MetaField value type"},"terminalId":{"type":"string","description":"Myriota terminal ID","maxLength":200}},"required":["type"]}}}}
```

## The TemplateEvent object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"TemplateEvent":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Event ID"},"name":{"type":"string","description":"Event name"},"eventCode":{"type":"string","description":"Event code for triggering"},"type":{"type":"string","description":"Event type","enum":["ONLINE","OFFLINE","INFORMATION","WARNING","CRITICAL","CONTENT","INACTIVE","LIFECYCLE","NOTE"]}},"required":["id","name","type"]}}}}
```

## The TemplateMetaField object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"TemplateMetaField":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"MetaField ID"},"name":{"type":"string","description":"MetaField name"},"type":{"type":"string","description":"MetaField type","enum":["MultiText","Text","Email","Number","Range","Shift","Switch","Cost","Contact","Measurement","Time","Coordinates","Address","List","Table","DeviceReference","Location","Tz","Image","DeviceName","DeviceOwner","HotspotName","Imei","ICCID","Int","DeviceEui","JoinEui","ApplicationKey","BluesDevice","OTASettings","TheThingsNetwork","MyriotaTerminalId","ThingName"]},"description":{"type":"string","description":"MetaField description"},"hint":{"type":"string","description":"MetaField hint for the provisioning form"},"icon":{"type":"string","description":"MetaField icon"}},"required":["id","name","type"]}}}}
```

## The BoardType object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"BoardType":{"type":"string","enum":["Arduino","BBC_Microbit","ESP32","ESP8266","Lantronix_Fox_3","Microduino","Onion_Omega","Particle","Pycom_WiPy","Raspberry_Pi","Seeed_Wio_Terminal","SparkFun_Blynk_Board","Teensy","TinyDuino","NodeRed","Python","TI_CC3220","Iridium","Iridium_9704_Launch_Pad","NCD","Milesight","Seeed","Blues","MOKOSmart","Thermokon","Miromiko","Pepperl_Fuchs","Atim","Other"],"description":"Device board type"}}}}
```

## The ConnectionType object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ConnectionType":{"type":"string","enum":["ETHERNET","WI_FI","USB","BLUETOOTH","BLE","GSM","SATELLITE","LORAWAN"],"description":"Connection type, that is used on the device"}}}}
```

## The DeviceLogEvent object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceLogEvent":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Log event unique ID"},"eventId":{"type":"integer","format":"int32","description":"Event ID, that was logged"},"orgId":{"type":"integer","format":"int32","description":"Organization ID, where event was logged"},"eventType":{"type":"string","enum":["ONLINE","OFFLINE","INFORMATION","WARNING","CRITICAL","CONTENT","INACTIVE","LIFECYCLE","NOTE"],"description":"Event type"},"description":{"type":"string","description":"Event description"},"ts":{"type":"integer","format":"int64","description":"Timestamp, when the event was triggered"},"isResolved":{"type":"boolean","description":"Whether the event is resolved"},"resolvedAt":{"type":"integer","format":"int64","description":"Timestamp, when the event was resolved"},"resolvedComment":{"type":"string","description":"Comment, added when the event was resolved"}},"required":["id","eventId","orgId","eventType","ts","isResolved"]}}}}
```

## The Tag object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"Tag":{"type":"object","properties":{"id":{"type":"integer","format":"int32"},"name":{"type":"string"},"color":{"type":"string","description":"Hex color code"}},"required":["id","name"]}}}}
```

## The Automation object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"Automation":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Automation ID"},"name":{"type":"string","description":"Automation name"},"ownerId":{"type":"integer","format":"int64","description":"User ID of the automation owner"},"isActive":{"type":"boolean","description":"Whether the automation is active"},"isShared":{"type":"boolean","description":"Whether the automation is shared with sub-organizations and has at least one propagated sub-automation."}}}}}}
```

## The AutomationRule object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"AutomationRule":{"type":"object","description":"The trigger + actions definition of an automation. This is a polymorphic\nobject whose concrete shape is selected by the `type` discriminator.\n","properties":{"type":{"type":"string","description":"Automation rule type.","enum":["SCENE","TIME","SUNSET","DS","TEMPLATE_EVENT"]},"trigger":{"type":"object","description":"Trigger configuration (absent for `SCENE` rules, which are triggered by the user)."},"actions":{"type":"array","description":"Ordered list of actions executed when the automation is triggered.","items":{"type":"object"}}}}}}}
```

## The AutomationRequest object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"AutomationRequest":{"type":"object","description":"Request body used to create or update an automation.","properties":{"id":{"type":"integer","format":"int32","description":"Automation ID. Required for update (PUT), ignored on create (POST)."},"name":{"type":"string","maxLength":255,"description":"Automation name."},"icon":{"type":"string","description":"Optional icon identifier."},"automationRule":{"$ref":"#/components/schemas/AutomationRule"},"isActive":{"type":"boolean","description":"Whether the automation is active."},"ignorePeriod":{"type":"integer","format":"int32","description":"Period (in milliseconds) during which repeated action execution is ignored. Must be >= 0."},"shareAsTemplate":{"type":"boolean","description":"Whether the automation is shared as a template."},"autoCreateInSubOrg":{"type":"boolean","description":"Whether the automation should be auto-created in sub-organizations. Requires the `SHARE_AUTOMATION` permission; otherwise silently ignored."},"autoEnable":{"type":"boolean","description":"Whether auto-created copies in sub-organizations are enabled by default."},"applyForExisting":{"type":"boolean","description":"When `autoCreateInSubOrg` is being turned on, whether to also propagate the automation into existing sub-organizations."},"removeForExisting":{"type":"boolean","description":"When `autoCreateInSubOrg` is being turned off (on update), whether to also remove previously auto-created copies from existing sub-organizations."}},"required":["name"]},"AutomationRule":{"type":"object","description":"The trigger + actions definition of an automation. This is a polymorphic\nobject whose concrete shape is selected by the `type` discriminator.\n","properties":{"type":{"type":"string","description":"Automation rule type.","enum":["SCENE","TIME","SUNSET","DS","TEMPLATE_EVENT"]},"trigger":{"type":"object","description":"Trigger configuration (absent for `SCENE` rules, which are triggered by the user)."},"actions":{"type":"array","description":"Ordered list of actions executed when the automation is triggered.","items":{"type":"object"}}}}}}}
```

## The AutomationControlRequest object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"AutomationControlRequest":{"type":"object","description":"Request body used by the enable, disable, execute and cancel endpoints.","properties":{"automationId":{"type":"integer","format":"int32","description":"ID of the target automation."}},"required":["automationId"]}}}}
```

## The AutomationDetailed object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"AutomationDetailed":{"type":"object","description":"Detailed automation representation returned by create, update, get-single and control endpoints.","properties":{"id":{"type":"integer","format":"int32"},"name":{"type":"string"},"icon":{"type":"string"},"automationRule":{"$ref":"#/components/schemas/AutomationRule"},"ownerId":{"type":"integer","format":"int64","description":"User ID of the automation owner (0 for organization-scoped tokens)."},"isActive":{"type":"boolean"},"lastTriggeredAt":{"type":"integer","format":"int64","description":"Timestamp (epoch millis) of the last time the automation was triggered."},"nextTriggeredAt":{"type":"integer","format":"int64","description":"Timestamp (epoch millis) of the next scheduled trigger, when applicable."},"status":{"type":"string","description":"Computed automation status.","enum":["COMPLETE","INCOMPLETE","ATTENTION"]},"ignorePeriod":{"type":"integer","format":"int32"},"waitDuration":{"type":"integer","format":"int64","description":"Total duration (in milliseconds) of any wait actions in the automation rule."},"shareAsTemplate":{"type":"boolean"},"autoCreateInSubOrg":{"type":"boolean"},"autoEnable":{"type":"boolean"},"isShared":{"type":"boolean","description":"Whether the automation is shared with sub-organizations and has at least one propagated sub-automation."}}},"AutomationRule":{"type":"object","description":"The trigger + actions definition of an automation. This is a polymorphic\nobject whose concrete shape is selected by the `type` discriminator.\n","properties":{"type":{"type":"string","description":"Automation rule type.","enum":["SCENE","TIME","SUNSET","DS","TEMPLATE_EVENT"]},"trigger":{"type":"object","description":"Trigger configuration (absent for `SCENE` rules, which are triggered by the user)."},"actions":{"type":"array","description":"Ordered list of actions executed when the automation is triggered.","items":{"type":"object"}}}}}}}
```

## The AutomationLogEntry object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"AutomationLogEntry":{"type":"object","description":"A single automation execution log record.","properties":{"ts":{"type":"integer","format":"int64","description":"Timestamp (epoch millis) of the log record."},"deviceId":{"type":"integer","format":"int32"},"deviceName":{"type":"string"},"dataStreamId":{"type":"integer","format":"int32"},"dataStreamName":{"type":"string"},"pin":{"type":"integer","format":"int32"},"pinType":{"type":"string"},"value":{"type":"number","format":"double"},"stringValue":{"type":"string"},"isOnline":{"type":"boolean"},"actionType":{"type":"string","description":"The type of action recorded."}}}}}}
```

## The Webhook object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"Webhook":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Webhook ID"},"name":{"type":"string","description":"Webhook name"},"trigger":{"type":"string","description":"Webhook trigger type","enum":["NEW_USER","DELETED_USER","UPDATED_USER","DEVICE_ADDED","DEVICE_DELETED","DEVICE_DATASTREAM_UPDATE","PRODUCT_DATASTREAM_UPDATE","GLOBAL_PRODUCT_DATASTREAM_UPDATE","DEVICE_LOG_EVENT","PRODUCT_LOG_EVENT","GLOBAL_PRODUCT_LOG_EVENT","FIRST_DEVICE_CONNECTION_IN_ORG","ORGANIZATION_ADDED"]},"dataTrigger":{"type":"object","description":"Data trigger configuration (for datastream or log event triggers)"},"url":{"type":"string","description":"Webhook URL. Supports placeholders such as `{device_id}`, `{user_id}`.","maxLength":512},"method":{"type":"string","description":"HTTP method for webhook","enum":["GET","POST","PUT","DELETE","PATCH"]},"contentType":{"type":"string","description":"Content type of the webhook request","enum":["PLAIN_TEXT","JSON","URL_ENCODED_FORM"]},"authType":{"type":"string","description":"Authentication type","enum":["NONE","BASIC","OAUTH2"]},"body":{"type":"string","description":"Request body template","maxLength":1024},"formBody":{"type":"object","additionalProperties":{"type":"string"},"description":"URL-encoded form body key-value pairs (used when contentType is URL_ENCODED_FORM)"},"queryParams":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}},"maxItems":20,"description":"Query parameters"},"basicAuthCredentials":{"type":"object","properties":{"name":{"type":"string","description":"Username"},"value":{"type":"string","description":"Password"}},"description":"Basic auth credentials (used when authType is BASIC)"},"oAuth2Request":{"type":"object","description":"OAuth2 configuration (used when authType is OAUTH2)"},"headers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}},"maxItems":20,"description":"Custom HTTP headers"},"failureReceivers":{"type":"array","items":{"type":"integer","format":"int64"},"maxItems":10,"description":"User IDs to notify on webhook failure"},"status":{"type":"string","description":"Webhook status","enum":["ENABLED","DISABLED","DISABLED_DUE_TO_ERRORS"]},"attemptCount":{"type":"integer","format":"int32","description":"Total number of execution attempts"},"createdAt":{"type":"integer","format":"int64","description":"Creation timestamp in milliseconds"},"lastModifiedTs":{"type":"integer","format":"int64","description":"Last modification timestamp in milliseconds"},"lastTriggeredTs":{"type":"integer","format":"int64","description":"Last trigger timestamp in milliseconds"},"failureLimit":{"type":"integer","format":"int32","description":"Number of consecutive failures before the webhook is disabled"}}}}}}
```

## The StaticToken object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"StaticToken":{"type":"object","properties":{"token":{"type":"string","description":"Static authentication token, that should be used for device claiming"},"orgId":{"type":"integer","format":"int32","description":"Organization ID, that the token belongs to"},"productId":{"type":"integer","format":"int32","description":"Template ID, that the token belongs to"},"deviceToken":{"type":"string","description":"Device token, that should be used on the device for authentication."},"createdAt":{"type":"integer","format":"int64","description":"Token creation timestamp"},"status":{"type":"string","enum":["CLAIMED","UNCLAIMED"],"description":"Static token status"},"ownerId":{"type":"integer","format":"int64","description":"User ID of the claimed device owner"},"deviceId":{"type":"integer","format":"int32","description":"Device ID of the claimed device"},"claimedOrgId":{"type":"integer","format":"int32","description":"Organization ID, that the device was claimed to"}},"required":["token","orgId","productId","deviceToken","createdAt","status"]}}}}
```

## The OAuthClient object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"OAuthClient":{"type":"object","properties":{"orgId":{"type":"integer","format":"int32","description":"Organization ID, that the client belongs to"},"name":{"type":"string","description":"Client application name"},"clientId":{"type":"string","description":"OAuth client ID"},"secret":{"type":"string","description":"OAuth client secret"},"redirectUrls":{"type":"array","items":{"type":"string"},"description":"Allowed redirect URIs"}},"required":["orgId","name","clientId","secret"]}}}}
```

## The DeviceActivation object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceActivation":{"type":"object","properties":{"id":{"type":"integer","format":"int32","description":"Device ID"},"orgId":{"type":"integer","format":"int32","description":"Organization ID"},"templateId":{"type":"integer","format":"int32","description":"Template ID"},"ownerUserId":{"type":"integer","format":"int64","description":"User ID of the device owner"},"activationTime":{"type":"integer","format":"int64","description":"Device activation timestamp"}},"required":["id","orgId","templateId","activationTime"]}}}}
```

## The ProvisionTokenResponse object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ProvisionTokenResponse":{"type":"object","properties":{"token":{"type":"string","description":"Provision token value"},"deviceId":{"type":"integer","format":"int32","description":"ID of the device associated with this token"}},"required":["token","deviceId"]}}}}
```

## The Shipment object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"Shipment":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Shipment unique identifier"},"productId":{"type":"integer","format":"int32","description":"Template (product) ID for this shipment"},"productName":{"type":"string","description":"Template (product) name"},"shipmentTime":{"type":"string","enum":["ANY","NIGHT","MORNING","AFTERNOON","EVENING"],"description":"Time window for the OTA update delivery"},"title":{"type":"string","description":"Shipment title"},"pathToFirmware":{"type":"string","description":"Server path to the firmware binary, as returned by the firmware upload endpoint (`POST /api/upload` with `type=FIRMWARE`)."},"firmwareOriginalFileName":{"type":"string","description":"Original firmware file name"},"host":{"type":"string","description":"Optional. Custom host domain name used for firmware download URL. If not set, the server's default host is used."},"startedByUserId":{"type":"integer","format":"int64","description":"ID of the user who started the shipment"},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (ms) when the shipment was started"},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (ms) when the shipment finished (0 if still running)"},"deviceIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"List of device IDs targeted by this shipment"},"firmwareInfo":{"$ref":"#/components/schemas/FirmwareInfo"},"attemptsLimit":{"type":"integer","format":"int32","description":"Maximum number of OTA delivery attempts per device"},"attemptResetPeriodMs":{"type":"integer","format":"int64","description":"Period (ms) after which the attempt counter resets"},"isSecure":{"type":"boolean","description":"Whether the firmware transfer uses a secure channel"},"skipFwTypeCheck":{"type":"boolean","description":"Whether to skip firmware type compatibility check"},"isCritical":{"type":"boolean","description":"Whether this is a critical update"},"sendPush":{"type":"boolean","description":"Whether push notifications were sent for this shipment"},"status":{"type":"string","enum":["RUN","PAUSE","FINISH","CANCEL"],"description":"Current shipment status"},"compareField":{"type":"string","enum":["NO_CONDITION","BUILD_DATE_DIFFERS","EARLIER_BUILD_DATE","LATEST_FIRMWARE_VERSION","LATEST_BLYNK_VERSION"],"description":"Condition used to determine whether the shipment should apply to a device"},"shipmentProgress":{"$ref":"#/components/schemas/ShipmentProgress"}}},"FirmwareInfo":{"type":"object","properties":{"version":{"type":"string","description":"Firmware version"},"blynkVersion":{"type":"string","description":"Blynk firmware version"},"fwType":{"type":"string","description":"Firmware type (product name)"},"boardType":{"type":"string","description":"Board type"},"buildDate":{"type":"string","description":"Firmware build date"},"md5Hash":{"type":"string","description":"MD5 hash of the firmware file"},"sha256Hash":{"type":"string","description":"SHA-256 hash of the firmware file"},"type":{"type":"string","enum":["NCP","MCU"],"description":"Firmware type"},"fileSize":{"type":"integer","format":"int32","description":"Firmware file size in bytes"}}},"ShipmentProgress":{"type":"object","properties":{"started":{"type":"integer","format":"int32","description":"Number of devices that started the OTA update"},"requestSent":{"type":"integer","format":"int32","description":"Number of devices that received the update request"},"firmwareRequested":{"type":"integer","format":"int32","description":"Number of devices that requested the firmware"},"firmwareUploaded":{"type":"integer","format":"int32","description":"Number of devices that completed firmware upload"},"firmwareUploadedToMobile":{"type":"integer","format":"int32","description":"Number of devices that uploaded firmware via mobile"},"success":{"type":"integer","format":"int32","description":"Number of devices that successfully updated"},"uploadFailure":{"type":"integer","format":"int32","description":"Number of devices that failed to upload firmware"},"firmwareTypeMismatch":{"type":"integer","format":"int32","description":"Number of devices with firmware type mismatch"},"downloadLimitReached":{"type":"integer","format":"int32","description":"Number of devices that reached the download limit"},"rollback":{"type":"integer","format":"int32","description":"Number of devices that rolled back"},"firmwareVersionMismatch":{"type":"integer","format":"int32","description":"Number of devices with firmware version mismatch"},"updatedAt":{"type":"integer","format":"int64","description":"Timestamp (ms) of the last progress update"}}}}}}
```

## The FirmwareInfo object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"FirmwareInfo":{"type":"object","properties":{"version":{"type":"string","description":"Firmware version"},"blynkVersion":{"type":"string","description":"Blynk firmware version"},"fwType":{"type":"string","description":"Firmware type (product name)"},"boardType":{"type":"string","description":"Board type"},"buildDate":{"type":"string","description":"Firmware build date"},"md5Hash":{"type":"string","description":"MD5 hash of the firmware file"},"sha256Hash":{"type":"string","description":"SHA-256 hash of the firmware file"},"type":{"type":"string","enum":["NCP","MCU"],"description":"Firmware type"},"fileSize":{"type":"integer","format":"int32","description":"Firmware file size in bytes"}}}}}}
```

## The FirmwareUploadResponse object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"FirmwareUploadResponse":{"type":"object","description":"Response returned by `POST /api/upload` when uploading a firmware file (`type=FIRMWARE`). Feed `path` into `pathToFirmware` and `firmwareInfo` into `firmwareInfo` of the create shipment request.","properties":{"path":{"type":"string","description":"Server path to the stored firmware file. Pass this value as `pathToFirmware` when creating a shipment."},"firmwareInfo":{"allOf":[{"$ref":"#/components/schemas/FirmwareInfo"}],"description":"Firmware metadata parsed from the uploaded file. Pass this object as `firmwareInfo` when creating a shipment. May be null if the file could not be parsed.","nullable":true}}},"FirmwareInfo":{"type":"object","properties":{"version":{"type":"string","description":"Firmware version"},"blynkVersion":{"type":"string","description":"Blynk firmware version"},"fwType":{"type":"string","description":"Firmware type (product name)"},"boardType":{"type":"string","description":"Board type"},"buildDate":{"type":"string","description":"Firmware build date"},"md5Hash":{"type":"string","description":"MD5 hash of the firmware file"},"sha256Hash":{"type":"string","description":"SHA-256 hash of the firmware file"},"type":{"type":"string","enum":["NCP","MCU"],"description":"Firmware type"},"fileSize":{"type":"integer","format":"int32","description":"Firmware file size in bytes"}}}}}}
```

## The ShipmentProgress object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ShipmentProgress":{"type":"object","properties":{"started":{"type":"integer","format":"int32","description":"Number of devices that started the OTA update"},"requestSent":{"type":"integer","format":"int32","description":"Number of devices that received the update request"},"firmwareRequested":{"type":"integer","format":"int32","description":"Number of devices that requested the firmware"},"firmwareUploaded":{"type":"integer","format":"int32","description":"Number of devices that completed firmware upload"},"firmwareUploadedToMobile":{"type":"integer","format":"int32","description":"Number of devices that uploaded firmware via mobile"},"success":{"type":"integer","format":"int32","description":"Number of devices that successfully updated"},"uploadFailure":{"type":"integer","format":"int32","description":"Number of devices that failed to upload firmware"},"firmwareTypeMismatch":{"type":"integer","format":"int32","description":"Number of devices with firmware type mismatch"},"downloadLimitReached":{"type":"integer","format":"int32","description":"Number of devices that reached the download limit"},"rollback":{"type":"integer","format":"int32","description":"Number of devices that rolled back"},"firmwareVersionMismatch":{"type":"integer","format":"int32","description":"Number of devices with firmware version mismatch"},"updatedAt":{"type":"integer","format":"int64","description":"Timestamp (ms) of the last progress update"}}}}}}
```

## The ErrorResponse object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}},"required":["message"]}},"required":["error"]}}}}
```

## The OAuth2Token object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"OAuth2Token":{"type":"object","description":"OAuth2 access token response.\n\n**Token lifetimes (subject to change):** Currently, access tokens expire after **24 hours** (86,400 seconds) and refresh tokens share the same lifetime. Always use the `expires_in` value from the response to determine the actual expiration rather than assuming a fixed TTL, as these defaults may be adjusted in the future.\n","properties":{"access_token":{"type":"string","description":"Access token for authenticating API requests. Use as `Bearer` token in the `Authorization` header."},"token_type":{"type":"string","enum":["Bearer"],"description":"Token type"},"expires_in":{"type":"integer","format":"int32","description":"Token expiration time in seconds. Currently defaults to 86,400 (24 hours). This value is subject to change — always rely on the returned value."},"refresh_token":{"type":"string","nullable":true,"description":"Refresh token for obtaining new access tokens. The refresh token currently shares the same lifetime as the access token (24 hours, subject to change). Each refresh token can only be used once."}},"required":["access_token","token_type","expires_in"]}}}}
```

## The OAuth2ErrorResponse object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"OAuth2ErrorResponse":{"type":"object","description":"OAuth2 error response following RFC 6749","properties":{"error":{"type":"string","description":"Error code","enum":["invalid_request","invalid_client","invalid_grant","unauthorized_client","unsupported_grant_type"]},"error_description":{"type":"string","description":"Human-readable error description"}},"required":["error","error_description"]}}}}
```

## The OAuth2IntrospectionResponse object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"OAuth2IntrospectionResponse":{"type":"object","description":"Token introspection response (RFC 7662 style).\n\nThis schema is a stable, versioned contract: only additive changes are made. For an inactive token only the\n`active` field is present (the body is exactly `{\"active\": false}`); all other fields are omitted.\n","properties":{"active":{"type":"boolean","description":"Whether the token is currently active (valid, not expired, not revoked, and local to this region)."},"org_id":{"type":"integer","format":"int32","description":"Organization the token belongs to. Present only for active tokens."},"grant_type":{"type":"string","enum":["client_credentials","user_credentials"],"description":"The grant type the token was issued with. Present only for active tokens."},"client_id":{"type":"string","description":"The OAuth2 client the token was issued to. Present only for active tokens."},"sub":{"type":"string","nullable":true,"description":"The user id the token is scoped to. Only present (non-null) for user-scoped tokens."},"role":{"type":"string","nullable":true,"description":"The user's organization role. Only present (non-null) for user-scoped tokens."},"exp":{"type":"integer","format":"int64","description":"Expiration time in epoch seconds. Present for active tokens; omitted for permanent tokens."},"iat":{"type":"integer","format":"int64","description":"Issued-at time in epoch seconds. Present only for active tokens."},"token_type":{"type":"string","enum":["Bearer"],"description":"Token type. Present only for active tokens."}},"required":["active"]}}}}
```

## The DecimalsFormat object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]}}}}
```

## The CustomDataRow object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"CustomDataRow":{"type":"object","description":"A single row of a custom data table.","properties":{"id":{"type":"integer","format":"int32","description":"Unique identifier of the row within its table."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"values":{"type":"array","description":"Column values of the row, one entry per table column, in the same order\nas the columns are defined in the table.\n","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"canEdit":{"type":"boolean","description":"Whether the authenticated user is allowed to edit this row."},"canDelete":{"type":"boolean","description":"Whether the authenticated user is allowed to delete this row."},"modifiedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) of the last row modification."}},"required":["id","orgId","values","canEdit","canDelete","modifiedAt"]},"CustomDataColumnValue":{"type":"object","description":"A single column value of a custom data table row. The concrete schema\ndepends on the `type` discriminator property, which reflects the type of\nthe column the value belongs to. Every value also carries the `columnName`\nit corresponds to.\n","discriminator":{"propertyName":"type","mapping":{"double":"#/components/schemas/DoubleCustomDataColumnValue","integer":"#/components/schemas/IntegerCustomDataColumnValue","list":"#/components/schemas/ListCustomDataColumnValue","null":"#/components/schemas/NullCustomDataColumnValue","text":"#/components/schemas/TextCustomDataColumnValue","device_reference":"#/components/schemas/DeviceReferenceCustomDataColumnValue","enum":"#/components/schemas/EnumCustomDataColumnValue","formula":"#/components/schemas/FormulaCustomDataColumnValue","created_at":"#/components/schemas/CreatedAtCustomDataColumnValue","modified_at":"#/components/schemas/ModifiedAtCustomDataColumnValue","created_by":"#/components/schemas/CreatedByCustomDataColumnValue","reference":"#/components/schemas/ReferenceCustomDataColumnValue","date":"#/components/schemas/DateCustomDataColumnValue","no_access":"#/components/schemas/NoAccessCustomDataColumnValue","aggregation":"#/components/schemas/AggregationCustomDataColumnValue","row_organization":"#/components/schemas/RowOrganizationCustomDataColumnValue","device_data_snapshot_reference":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue","boolean":"#/components/schemas/BooleanCustomDataColumnValue","date_time":"#/components/schemas/DateTimeCustomDataColumnValue"}},"oneOf":[{"$ref":"#/components/schemas/DoubleCustomDataColumnValue"},{"$ref":"#/components/schemas/IntegerCustomDataColumnValue"},{"$ref":"#/components/schemas/ListCustomDataColumnValue"},{"$ref":"#/components/schemas/NullCustomDataColumnValue"},{"$ref":"#/components/schemas/TextCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/EnumCustomDataColumnValue"},{"$ref":"#/components/schemas/FormulaCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/ModifiedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedByCustomDataColumnValue"},{"$ref":"#/components/schemas/ReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/DateCustomDataColumnValue"},{"$ref":"#/components/schemas/NoAccessCustomDataColumnValue"},{"$ref":"#/components/schemas/AggregationCustomDataColumnValue"},{"$ref":"#/components/schemas/RowOrganizationCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/BooleanCustomDataColumnValue"},{"$ref":"#/components/schemas/DateTimeCustomDataColumnValue"}]},"DoubleCustomDataColumnValue":{"type":"object","description":"Value of a decimal (double) column.","properties":{"type":{"type":"string","enum":["double"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"IntegerCustomDataColumnValue":{"type":"object","description":"Value of an integer column.","properties":{"type":{"type":"string","enum":["integer"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The integer value."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"ListCustomDataColumnValue":{"type":"object","description":"Value of a list column, holding an ordered collection of nested column values.","properties":{"type":{"type":"string","enum":["list"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"array","description":"The list items, each being a nested column value.","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}}},"required":["type","columnName","value"]},"NullCustomDataColumnValue":{"type":"object","description":"Represents an empty (unset) column value.","properties":{"type":{"type":"string","enum":["null"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"TextCustomDataColumnValue":{"type":"object","description":"Value of a text column.","properties":{"type":{"type":"string","enum":["text"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"string","nullable":true,"description":"The text value. May be `null` when the cell is empty."}},"required":["type","columnName"]},"DeviceReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device.","properties":{"type":{"type":"string","enum":["device_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the referenced device. May be `null` when no device is referenced."},"deviceOrgId":{"type":"integer","format":"int32","nullable":true,"description":"Identifier of the organization the referenced device belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the referenced device."}},"required":["type","columnName","deviceId"]},"EnumCustomDataColumnValue":{"type":"object","description":"Value of an enum column.","properties":{"type":{"type":"string","enum":["enum"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The numeric enum value, mapped to a display name in the column configuration."},"valueDisplayName":{"type":"string","nullable":true,"description":"Human-readable display name mapped to the numeric value."}},"required":["type","columnName","value"]},"FormulaCustomDataColumnValue":{"type":"object","description":"Computed value of a formula column.","properties":{"type":{"type":"string","enum":["formula"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed decimal value of the formula."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"CreatedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was created.","properties":{"type":{"type":"string","enum":["created_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was created."}},"required":["type","columnName","value"]},"ModifiedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was last modified.","properties":{"type":{"type":"string","enum":["modified_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was last modified."}},"required":["type","columnName","value"]},"CreatedByCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the user who created the row.","properties":{"type":{"type":"string","enum":["created_by"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"userId":{"type":"integer","format":"int64","description":"Identifier of the user who created the row."},"userName":{"type":"string","nullable":true,"description":"Name of the user who created the row."},"userEmail":{"type":"string","nullable":true,"description":"Email of the user who created the row."}},"required":["type","columnName","userId"]},"ReferenceCustomDataColumnValue":{"type":"object","description":"Value of a reference column that points to a row in another custom data table.","properties":{"type":{"type":"string","enum":["reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"rowId":{"type":"integer","format":"int32","description":"Identifier of the referenced row. May be `null` when no row is referenced."},"row":{"allOf":[{"$ref":"#/components/schemas/CustomDataRow"}],"nullable":true,"description":"The referenced row, resolved when references are computed."},"tableName":{"type":"string","nullable":true,"description":"Name of the table the referenced row belongs to."},"displayColumn":{"type":"string","nullable":true,"description":"Name of the column used to display the referenced row."}},"required":["type","columnName","rowId","tableName"]},"DateCustomDataColumnValue":{"type":"object","description":"Value of a date column, represented as separate day, month and year fields.","properties":{"type":{"type":"string","enum":["date"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"day":{"type":"integer","format":"int32","description":"Day of month (1-31)."},"month":{"type":"integer","format":"int32","description":"Month of year (1-12)."},"year":{"type":"integer","format":"int32","description":"Four-digit year."}},"required":["type","columnName","day","month","year"]},"NoAccessCustomDataColumnValue":{"type":"object","description":"Placeholder returned instead of the actual value when the authenticated\nuser does not have access to the underlying data of the column.\n","properties":{"type":{"type":"string","enum":["no_access"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"AggregationCustomDataColumnValue":{"type":"object","description":"Computed value of an aggregation column (e.g. sum, average over referenced rows).","properties":{"type":{"type":"string","enum":["aggregation"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed aggregated decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"RowOrganizationCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the organization a row belongs to.","properties":{"type":{"type":"string","enum":["row_organization"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"orgName":{"type":"string","nullable":true,"description":"Name of the organization the row belongs to."}},"required":["type","columnName","orgId"]},"DeviceDataSnapshotReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device data snapshot.","properties":{"type":{"type":"string","enum":["device_data_snapshot_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"snapshotId":{"type":"integer","format":"int32","description":"Identifier of the referenced snapshot."},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot started."},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot finished."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the device the snapshot belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the device the snapshot belongs to."}},"required":["type","columnName","snapshotId","startedAt","finishedAt","deviceId"]},"BooleanCustomDataColumnValue":{"type":"object","description":"Value of a boolean column.","properties":{"type":{"type":"string","enum":["boolean"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"boolean","description":"The boolean value."}},"required":["type","columnName","value"]},"DateTimeCustomDataColumnValue":{"type":"object","description":"Value of a date-time column.","properties":{"type":{"type":"string","enum":["date_time"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds)."}},"required":["type","columnName","value"]}}}}
```

## The CustomDataRowFilter object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"CustomDataRowFilter":{"type":"object","nullable":true,"description":"A filter applied to the table rows. The concrete schema depends on the\n`type` discriminator property.\n","discriminator":{"propertyName":"type","mapping":{"and":"#/components/schemas/AndCustomDataRowFilter","or":"#/components/schemas/OrCustomDataRowFilter","column_equal":"#/components/schemas/ColumnEqualCustomDataRowFilter","list_contains":"#/components/schemas/ListContainValueCustomDataRowFilter"}},"oneOf":[{"$ref":"#/components/schemas/AndCustomDataRowFilter"},{"$ref":"#/components/schemas/OrCustomDataRowFilter"},{"$ref":"#/components/schemas/ColumnEqualCustomDataRowFilter"},{"$ref":"#/components/schemas/ListContainValueCustomDataRowFilter"}]},"AndCustomDataRowFilter":{"type":"object","description":"Matches rows that satisfy all of the nested filters.","properties":{"type":{"type":"string","enum":["and"]},"filters":{"type":"array","maxItems":10,"description":"Nested filters that must all match.","items":{"$ref":"#/components/schemas/CustomDataRowFilter"}}},"required":["type","filters"]},"OrCustomDataRowFilter":{"type":"object","description":"Matches rows that satisfy at least one of the nested filters.","properties":{"type":{"type":"string","enum":["or"]},"filters":{"type":"array","maxItems":10,"description":"Nested filters, at least one of which must match.","items":{"$ref":"#/components/schemas/CustomDataRowFilter"}}},"required":["type","filters"]},"ColumnEqualCustomDataRowFilter":{"type":"object","description":"Matches rows where the given column equals the provided value. A `null`\ncolumn value matches rows where the column is empty.\n","properties":{"type":{"type":"string","enum":["column_equal"]},"value":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"required":["type","value"]},"CustomDataColumnValue":{"type":"object","description":"A single column value of a custom data table row. The concrete schema\ndepends on the `type` discriminator property, which reflects the type of\nthe column the value belongs to. Every value also carries the `columnName`\nit corresponds to.\n","discriminator":{"propertyName":"type","mapping":{"double":"#/components/schemas/DoubleCustomDataColumnValue","integer":"#/components/schemas/IntegerCustomDataColumnValue","list":"#/components/schemas/ListCustomDataColumnValue","null":"#/components/schemas/NullCustomDataColumnValue","text":"#/components/schemas/TextCustomDataColumnValue","device_reference":"#/components/schemas/DeviceReferenceCustomDataColumnValue","enum":"#/components/schemas/EnumCustomDataColumnValue","formula":"#/components/schemas/FormulaCustomDataColumnValue","created_at":"#/components/schemas/CreatedAtCustomDataColumnValue","modified_at":"#/components/schemas/ModifiedAtCustomDataColumnValue","created_by":"#/components/schemas/CreatedByCustomDataColumnValue","reference":"#/components/schemas/ReferenceCustomDataColumnValue","date":"#/components/schemas/DateCustomDataColumnValue","no_access":"#/components/schemas/NoAccessCustomDataColumnValue","aggregation":"#/components/schemas/AggregationCustomDataColumnValue","row_organization":"#/components/schemas/RowOrganizationCustomDataColumnValue","device_data_snapshot_reference":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue","boolean":"#/components/schemas/BooleanCustomDataColumnValue","date_time":"#/components/schemas/DateTimeCustomDataColumnValue"}},"oneOf":[{"$ref":"#/components/schemas/DoubleCustomDataColumnValue"},{"$ref":"#/components/schemas/IntegerCustomDataColumnValue"},{"$ref":"#/components/schemas/ListCustomDataColumnValue"},{"$ref":"#/components/schemas/NullCustomDataColumnValue"},{"$ref":"#/components/schemas/TextCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/EnumCustomDataColumnValue"},{"$ref":"#/components/schemas/FormulaCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/ModifiedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedByCustomDataColumnValue"},{"$ref":"#/components/schemas/ReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/DateCustomDataColumnValue"},{"$ref":"#/components/schemas/NoAccessCustomDataColumnValue"},{"$ref":"#/components/schemas/AggregationCustomDataColumnValue"},{"$ref":"#/components/schemas/RowOrganizationCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/BooleanCustomDataColumnValue"},{"$ref":"#/components/schemas/DateTimeCustomDataColumnValue"}]},"DoubleCustomDataColumnValue":{"type":"object","description":"Value of a decimal (double) column.","properties":{"type":{"type":"string","enum":["double"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"IntegerCustomDataColumnValue":{"type":"object","description":"Value of an integer column.","properties":{"type":{"type":"string","enum":["integer"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The integer value."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"ListCustomDataColumnValue":{"type":"object","description":"Value of a list column, holding an ordered collection of nested column values.","properties":{"type":{"type":"string","enum":["list"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"array","description":"The list items, each being a nested column value.","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}}},"required":["type","columnName","value"]},"NullCustomDataColumnValue":{"type":"object","description":"Represents an empty (unset) column value.","properties":{"type":{"type":"string","enum":["null"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"TextCustomDataColumnValue":{"type":"object","description":"Value of a text column.","properties":{"type":{"type":"string","enum":["text"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"string","nullable":true,"description":"The text value. May be `null` when the cell is empty."}},"required":["type","columnName"]},"DeviceReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device.","properties":{"type":{"type":"string","enum":["device_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the referenced device. May be `null` when no device is referenced."},"deviceOrgId":{"type":"integer","format":"int32","nullable":true,"description":"Identifier of the organization the referenced device belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the referenced device."}},"required":["type","columnName","deviceId"]},"EnumCustomDataColumnValue":{"type":"object","description":"Value of an enum column.","properties":{"type":{"type":"string","enum":["enum"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The numeric enum value, mapped to a display name in the column configuration."},"valueDisplayName":{"type":"string","nullable":true,"description":"Human-readable display name mapped to the numeric value."}},"required":["type","columnName","value"]},"FormulaCustomDataColumnValue":{"type":"object","description":"Computed value of a formula column.","properties":{"type":{"type":"string","enum":["formula"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed decimal value of the formula."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"CreatedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was created.","properties":{"type":{"type":"string","enum":["created_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was created."}},"required":["type","columnName","value"]},"ModifiedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was last modified.","properties":{"type":{"type":"string","enum":["modified_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was last modified."}},"required":["type","columnName","value"]},"CreatedByCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the user who created the row.","properties":{"type":{"type":"string","enum":["created_by"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"userId":{"type":"integer","format":"int64","description":"Identifier of the user who created the row."},"userName":{"type":"string","nullable":true,"description":"Name of the user who created the row."},"userEmail":{"type":"string","nullable":true,"description":"Email of the user who created the row."}},"required":["type","columnName","userId"]},"ReferenceCustomDataColumnValue":{"type":"object","description":"Value of a reference column that points to a row in another custom data table.","properties":{"type":{"type":"string","enum":["reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"rowId":{"type":"integer","format":"int32","description":"Identifier of the referenced row. May be `null` when no row is referenced."},"row":{"allOf":[{"$ref":"#/components/schemas/CustomDataRow"}],"nullable":true,"description":"The referenced row, resolved when references are computed."},"tableName":{"type":"string","nullable":true,"description":"Name of the table the referenced row belongs to."},"displayColumn":{"type":"string","nullable":true,"description":"Name of the column used to display the referenced row."}},"required":["type","columnName","rowId","tableName"]},"CustomDataRow":{"type":"object","description":"A single row of a custom data table.","properties":{"id":{"type":"integer","format":"int32","description":"Unique identifier of the row within its table."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"values":{"type":"array","description":"Column values of the row, one entry per table column, in the same order\nas the columns are defined in the table.\n","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"canEdit":{"type":"boolean","description":"Whether the authenticated user is allowed to edit this row."},"canDelete":{"type":"boolean","description":"Whether the authenticated user is allowed to delete this row."},"modifiedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) of the last row modification."}},"required":["id","orgId","values","canEdit","canDelete","modifiedAt"]},"DateCustomDataColumnValue":{"type":"object","description":"Value of a date column, represented as separate day, month and year fields.","properties":{"type":{"type":"string","enum":["date"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"day":{"type":"integer","format":"int32","description":"Day of month (1-31)."},"month":{"type":"integer","format":"int32","description":"Month of year (1-12)."},"year":{"type":"integer","format":"int32","description":"Four-digit year."}},"required":["type","columnName","day","month","year"]},"NoAccessCustomDataColumnValue":{"type":"object","description":"Placeholder returned instead of the actual value when the authenticated\nuser does not have access to the underlying data of the column.\n","properties":{"type":{"type":"string","enum":["no_access"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"AggregationCustomDataColumnValue":{"type":"object","description":"Computed value of an aggregation column (e.g. sum, average over referenced rows).","properties":{"type":{"type":"string","enum":["aggregation"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed aggregated decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"RowOrganizationCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the organization a row belongs to.","properties":{"type":{"type":"string","enum":["row_organization"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"orgName":{"type":"string","nullable":true,"description":"Name of the organization the row belongs to."}},"required":["type","columnName","orgId"]},"DeviceDataSnapshotReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device data snapshot.","properties":{"type":{"type":"string","enum":["device_data_snapshot_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"snapshotId":{"type":"integer","format":"int32","description":"Identifier of the referenced snapshot."},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot started."},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot finished."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the device the snapshot belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the device the snapshot belongs to."}},"required":["type","columnName","snapshotId","startedAt","finishedAt","deviceId"]},"BooleanCustomDataColumnValue":{"type":"object","description":"Value of a boolean column.","properties":{"type":{"type":"string","enum":["boolean"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"boolean","description":"The boolean value."}},"required":["type","columnName","value"]},"DateTimeCustomDataColumnValue":{"type":"object","description":"Value of a date-time column.","properties":{"type":{"type":"string","enum":["date_time"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds)."}},"required":["type","columnName","value"]},"ListContainValueCustomDataRowFilter":{"type":"object","description":"Matches rows where the given list column contains the provided value.\n","properties":{"type":{"type":"string","enum":["list_contains"]},"listColumnName":{"type":"string","description":"Name of the list column to inspect."},"value":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"required":["type","value"]}}}}
```

## The AndCustomDataRowFilter object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"AndCustomDataRowFilter":{"type":"object","description":"Matches rows that satisfy all of the nested filters.","properties":{"type":{"type":"string","enum":["and"]},"filters":{"type":"array","maxItems":10,"description":"Nested filters that must all match.","items":{"$ref":"#/components/schemas/CustomDataRowFilter"}}},"required":["type","filters"]},"CustomDataRowFilter":{"type":"object","nullable":true,"description":"A filter applied to the table rows. The concrete schema depends on the\n`type` discriminator property.\n","discriminator":{"propertyName":"type","mapping":{"and":"#/components/schemas/AndCustomDataRowFilter","or":"#/components/schemas/OrCustomDataRowFilter","column_equal":"#/components/schemas/ColumnEqualCustomDataRowFilter","list_contains":"#/components/schemas/ListContainValueCustomDataRowFilter"}},"oneOf":[{"$ref":"#/components/schemas/AndCustomDataRowFilter"},{"$ref":"#/components/schemas/OrCustomDataRowFilter"},{"$ref":"#/components/schemas/ColumnEqualCustomDataRowFilter"},{"$ref":"#/components/schemas/ListContainValueCustomDataRowFilter"}]},"OrCustomDataRowFilter":{"type":"object","description":"Matches rows that satisfy at least one of the nested filters.","properties":{"type":{"type":"string","enum":["or"]},"filters":{"type":"array","maxItems":10,"description":"Nested filters, at least one of which must match.","items":{"$ref":"#/components/schemas/CustomDataRowFilter"}}},"required":["type","filters"]},"ColumnEqualCustomDataRowFilter":{"type":"object","description":"Matches rows where the given column equals the provided value. A `null`\ncolumn value matches rows where the column is empty.\n","properties":{"type":{"type":"string","enum":["column_equal"]},"value":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"required":["type","value"]},"CustomDataColumnValue":{"type":"object","description":"A single column value of a custom data table row. The concrete schema\ndepends on the `type` discriminator property, which reflects the type of\nthe column the value belongs to. Every value also carries the `columnName`\nit corresponds to.\n","discriminator":{"propertyName":"type","mapping":{"double":"#/components/schemas/DoubleCustomDataColumnValue","integer":"#/components/schemas/IntegerCustomDataColumnValue","list":"#/components/schemas/ListCustomDataColumnValue","null":"#/components/schemas/NullCustomDataColumnValue","text":"#/components/schemas/TextCustomDataColumnValue","device_reference":"#/components/schemas/DeviceReferenceCustomDataColumnValue","enum":"#/components/schemas/EnumCustomDataColumnValue","formula":"#/components/schemas/FormulaCustomDataColumnValue","created_at":"#/components/schemas/CreatedAtCustomDataColumnValue","modified_at":"#/components/schemas/ModifiedAtCustomDataColumnValue","created_by":"#/components/schemas/CreatedByCustomDataColumnValue","reference":"#/components/schemas/ReferenceCustomDataColumnValue","date":"#/components/schemas/DateCustomDataColumnValue","no_access":"#/components/schemas/NoAccessCustomDataColumnValue","aggregation":"#/components/schemas/AggregationCustomDataColumnValue","row_organization":"#/components/schemas/RowOrganizationCustomDataColumnValue","device_data_snapshot_reference":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue","boolean":"#/components/schemas/BooleanCustomDataColumnValue","date_time":"#/components/schemas/DateTimeCustomDataColumnValue"}},"oneOf":[{"$ref":"#/components/schemas/DoubleCustomDataColumnValue"},{"$ref":"#/components/schemas/IntegerCustomDataColumnValue"},{"$ref":"#/components/schemas/ListCustomDataColumnValue"},{"$ref":"#/components/schemas/NullCustomDataColumnValue"},{"$ref":"#/components/schemas/TextCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/EnumCustomDataColumnValue"},{"$ref":"#/components/schemas/FormulaCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/ModifiedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedByCustomDataColumnValue"},{"$ref":"#/components/schemas/ReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/DateCustomDataColumnValue"},{"$ref":"#/components/schemas/NoAccessCustomDataColumnValue"},{"$ref":"#/components/schemas/AggregationCustomDataColumnValue"},{"$ref":"#/components/schemas/RowOrganizationCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/BooleanCustomDataColumnValue"},{"$ref":"#/components/schemas/DateTimeCustomDataColumnValue"}]},"DoubleCustomDataColumnValue":{"type":"object","description":"Value of a decimal (double) column.","properties":{"type":{"type":"string","enum":["double"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"IntegerCustomDataColumnValue":{"type":"object","description":"Value of an integer column.","properties":{"type":{"type":"string","enum":["integer"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The integer value."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"ListCustomDataColumnValue":{"type":"object","description":"Value of a list column, holding an ordered collection of nested column values.","properties":{"type":{"type":"string","enum":["list"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"array","description":"The list items, each being a nested column value.","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}}},"required":["type","columnName","value"]},"NullCustomDataColumnValue":{"type":"object","description":"Represents an empty (unset) column value.","properties":{"type":{"type":"string","enum":["null"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"TextCustomDataColumnValue":{"type":"object","description":"Value of a text column.","properties":{"type":{"type":"string","enum":["text"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"string","nullable":true,"description":"The text value. May be `null` when the cell is empty."}},"required":["type","columnName"]},"DeviceReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device.","properties":{"type":{"type":"string","enum":["device_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the referenced device. May be `null` when no device is referenced."},"deviceOrgId":{"type":"integer","format":"int32","nullable":true,"description":"Identifier of the organization the referenced device belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the referenced device."}},"required":["type","columnName","deviceId"]},"EnumCustomDataColumnValue":{"type":"object","description":"Value of an enum column.","properties":{"type":{"type":"string","enum":["enum"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The numeric enum value, mapped to a display name in the column configuration."},"valueDisplayName":{"type":"string","nullable":true,"description":"Human-readable display name mapped to the numeric value."}},"required":["type","columnName","value"]},"FormulaCustomDataColumnValue":{"type":"object","description":"Computed value of a formula column.","properties":{"type":{"type":"string","enum":["formula"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed decimal value of the formula."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"CreatedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was created.","properties":{"type":{"type":"string","enum":["created_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was created."}},"required":["type","columnName","value"]},"ModifiedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was last modified.","properties":{"type":{"type":"string","enum":["modified_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was last modified."}},"required":["type","columnName","value"]},"CreatedByCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the user who created the row.","properties":{"type":{"type":"string","enum":["created_by"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"userId":{"type":"integer","format":"int64","description":"Identifier of the user who created the row."},"userName":{"type":"string","nullable":true,"description":"Name of the user who created the row."},"userEmail":{"type":"string","nullable":true,"description":"Email of the user who created the row."}},"required":["type","columnName","userId"]},"ReferenceCustomDataColumnValue":{"type":"object","description":"Value of a reference column that points to a row in another custom data table.","properties":{"type":{"type":"string","enum":["reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"rowId":{"type":"integer","format":"int32","description":"Identifier of the referenced row. May be `null` when no row is referenced."},"row":{"allOf":[{"$ref":"#/components/schemas/CustomDataRow"}],"nullable":true,"description":"The referenced row, resolved when references are computed."},"tableName":{"type":"string","nullable":true,"description":"Name of the table the referenced row belongs to."},"displayColumn":{"type":"string","nullable":true,"description":"Name of the column used to display the referenced row."}},"required":["type","columnName","rowId","tableName"]},"CustomDataRow":{"type":"object","description":"A single row of a custom data table.","properties":{"id":{"type":"integer","format":"int32","description":"Unique identifier of the row within its table."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"values":{"type":"array","description":"Column values of the row, one entry per table column, in the same order\nas the columns are defined in the table.\n","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"canEdit":{"type":"boolean","description":"Whether the authenticated user is allowed to edit this row."},"canDelete":{"type":"boolean","description":"Whether the authenticated user is allowed to delete this row."},"modifiedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) of the last row modification."}},"required":["id","orgId","values","canEdit","canDelete","modifiedAt"]},"DateCustomDataColumnValue":{"type":"object","description":"Value of a date column, represented as separate day, month and year fields.","properties":{"type":{"type":"string","enum":["date"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"day":{"type":"integer","format":"int32","description":"Day of month (1-31)."},"month":{"type":"integer","format":"int32","description":"Month of year (1-12)."},"year":{"type":"integer","format":"int32","description":"Four-digit year."}},"required":["type","columnName","day","month","year"]},"NoAccessCustomDataColumnValue":{"type":"object","description":"Placeholder returned instead of the actual value when the authenticated\nuser does not have access to the underlying data of the column.\n","properties":{"type":{"type":"string","enum":["no_access"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"AggregationCustomDataColumnValue":{"type":"object","description":"Computed value of an aggregation column (e.g. sum, average over referenced rows).","properties":{"type":{"type":"string","enum":["aggregation"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed aggregated decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"RowOrganizationCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the organization a row belongs to.","properties":{"type":{"type":"string","enum":["row_organization"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"orgName":{"type":"string","nullable":true,"description":"Name of the organization the row belongs to."}},"required":["type","columnName","orgId"]},"DeviceDataSnapshotReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device data snapshot.","properties":{"type":{"type":"string","enum":["device_data_snapshot_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"snapshotId":{"type":"integer","format":"int32","description":"Identifier of the referenced snapshot."},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot started."},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot finished."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the device the snapshot belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the device the snapshot belongs to."}},"required":["type","columnName","snapshotId","startedAt","finishedAt","deviceId"]},"BooleanCustomDataColumnValue":{"type":"object","description":"Value of a boolean column.","properties":{"type":{"type":"string","enum":["boolean"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"boolean","description":"The boolean value."}},"required":["type","columnName","value"]},"DateTimeCustomDataColumnValue":{"type":"object","description":"Value of a date-time column.","properties":{"type":{"type":"string","enum":["date_time"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds)."}},"required":["type","columnName","value"]},"ListContainValueCustomDataRowFilter":{"type":"object","description":"Matches rows where the given list column contains the provided value.\n","properties":{"type":{"type":"string","enum":["list_contains"]},"listColumnName":{"type":"string","description":"Name of the list column to inspect."},"value":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"required":["type","value"]}}}}
```

## The OrCustomDataRowFilter object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"OrCustomDataRowFilter":{"type":"object","description":"Matches rows that satisfy at least one of the nested filters.","properties":{"type":{"type":"string","enum":["or"]},"filters":{"type":"array","maxItems":10,"description":"Nested filters, at least one of which must match.","items":{"$ref":"#/components/schemas/CustomDataRowFilter"}}},"required":["type","filters"]},"CustomDataRowFilter":{"type":"object","nullable":true,"description":"A filter applied to the table rows. The concrete schema depends on the\n`type` discriminator property.\n","discriminator":{"propertyName":"type","mapping":{"and":"#/components/schemas/AndCustomDataRowFilter","or":"#/components/schemas/OrCustomDataRowFilter","column_equal":"#/components/schemas/ColumnEqualCustomDataRowFilter","list_contains":"#/components/schemas/ListContainValueCustomDataRowFilter"}},"oneOf":[{"$ref":"#/components/schemas/AndCustomDataRowFilter"},{"$ref":"#/components/schemas/OrCustomDataRowFilter"},{"$ref":"#/components/schemas/ColumnEqualCustomDataRowFilter"},{"$ref":"#/components/schemas/ListContainValueCustomDataRowFilter"}]},"AndCustomDataRowFilter":{"type":"object","description":"Matches rows that satisfy all of the nested filters.","properties":{"type":{"type":"string","enum":["and"]},"filters":{"type":"array","maxItems":10,"description":"Nested filters that must all match.","items":{"$ref":"#/components/schemas/CustomDataRowFilter"}}},"required":["type","filters"]},"ColumnEqualCustomDataRowFilter":{"type":"object","description":"Matches rows where the given column equals the provided value. A `null`\ncolumn value matches rows where the column is empty.\n","properties":{"type":{"type":"string","enum":["column_equal"]},"value":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"required":["type","value"]},"CustomDataColumnValue":{"type":"object","description":"A single column value of a custom data table row. The concrete schema\ndepends on the `type` discriminator property, which reflects the type of\nthe column the value belongs to. Every value also carries the `columnName`\nit corresponds to.\n","discriminator":{"propertyName":"type","mapping":{"double":"#/components/schemas/DoubleCustomDataColumnValue","integer":"#/components/schemas/IntegerCustomDataColumnValue","list":"#/components/schemas/ListCustomDataColumnValue","null":"#/components/schemas/NullCustomDataColumnValue","text":"#/components/schemas/TextCustomDataColumnValue","device_reference":"#/components/schemas/DeviceReferenceCustomDataColumnValue","enum":"#/components/schemas/EnumCustomDataColumnValue","formula":"#/components/schemas/FormulaCustomDataColumnValue","created_at":"#/components/schemas/CreatedAtCustomDataColumnValue","modified_at":"#/components/schemas/ModifiedAtCustomDataColumnValue","created_by":"#/components/schemas/CreatedByCustomDataColumnValue","reference":"#/components/schemas/ReferenceCustomDataColumnValue","date":"#/components/schemas/DateCustomDataColumnValue","no_access":"#/components/schemas/NoAccessCustomDataColumnValue","aggregation":"#/components/schemas/AggregationCustomDataColumnValue","row_organization":"#/components/schemas/RowOrganizationCustomDataColumnValue","device_data_snapshot_reference":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue","boolean":"#/components/schemas/BooleanCustomDataColumnValue","date_time":"#/components/schemas/DateTimeCustomDataColumnValue"}},"oneOf":[{"$ref":"#/components/schemas/DoubleCustomDataColumnValue"},{"$ref":"#/components/schemas/IntegerCustomDataColumnValue"},{"$ref":"#/components/schemas/ListCustomDataColumnValue"},{"$ref":"#/components/schemas/NullCustomDataColumnValue"},{"$ref":"#/components/schemas/TextCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/EnumCustomDataColumnValue"},{"$ref":"#/components/schemas/FormulaCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/ModifiedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedByCustomDataColumnValue"},{"$ref":"#/components/schemas/ReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/DateCustomDataColumnValue"},{"$ref":"#/components/schemas/NoAccessCustomDataColumnValue"},{"$ref":"#/components/schemas/AggregationCustomDataColumnValue"},{"$ref":"#/components/schemas/RowOrganizationCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/BooleanCustomDataColumnValue"},{"$ref":"#/components/schemas/DateTimeCustomDataColumnValue"}]},"DoubleCustomDataColumnValue":{"type":"object","description":"Value of a decimal (double) column.","properties":{"type":{"type":"string","enum":["double"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"IntegerCustomDataColumnValue":{"type":"object","description":"Value of an integer column.","properties":{"type":{"type":"string","enum":["integer"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The integer value."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"ListCustomDataColumnValue":{"type":"object","description":"Value of a list column, holding an ordered collection of nested column values.","properties":{"type":{"type":"string","enum":["list"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"array","description":"The list items, each being a nested column value.","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}}},"required":["type","columnName","value"]},"NullCustomDataColumnValue":{"type":"object","description":"Represents an empty (unset) column value.","properties":{"type":{"type":"string","enum":["null"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"TextCustomDataColumnValue":{"type":"object","description":"Value of a text column.","properties":{"type":{"type":"string","enum":["text"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"string","nullable":true,"description":"The text value. May be `null` when the cell is empty."}},"required":["type","columnName"]},"DeviceReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device.","properties":{"type":{"type":"string","enum":["device_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the referenced device. May be `null` when no device is referenced."},"deviceOrgId":{"type":"integer","format":"int32","nullable":true,"description":"Identifier of the organization the referenced device belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the referenced device."}},"required":["type","columnName","deviceId"]},"EnumCustomDataColumnValue":{"type":"object","description":"Value of an enum column.","properties":{"type":{"type":"string","enum":["enum"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The numeric enum value, mapped to a display name in the column configuration."},"valueDisplayName":{"type":"string","nullable":true,"description":"Human-readable display name mapped to the numeric value."}},"required":["type","columnName","value"]},"FormulaCustomDataColumnValue":{"type":"object","description":"Computed value of a formula column.","properties":{"type":{"type":"string","enum":["formula"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed decimal value of the formula."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"CreatedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was created.","properties":{"type":{"type":"string","enum":["created_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was created."}},"required":["type","columnName","value"]},"ModifiedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was last modified.","properties":{"type":{"type":"string","enum":["modified_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was last modified."}},"required":["type","columnName","value"]},"CreatedByCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the user who created the row.","properties":{"type":{"type":"string","enum":["created_by"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"userId":{"type":"integer","format":"int64","description":"Identifier of the user who created the row."},"userName":{"type":"string","nullable":true,"description":"Name of the user who created the row."},"userEmail":{"type":"string","nullable":true,"description":"Email of the user who created the row."}},"required":["type","columnName","userId"]},"ReferenceCustomDataColumnValue":{"type":"object","description":"Value of a reference column that points to a row in another custom data table.","properties":{"type":{"type":"string","enum":["reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"rowId":{"type":"integer","format":"int32","description":"Identifier of the referenced row. May be `null` when no row is referenced."},"row":{"allOf":[{"$ref":"#/components/schemas/CustomDataRow"}],"nullable":true,"description":"The referenced row, resolved when references are computed."},"tableName":{"type":"string","nullable":true,"description":"Name of the table the referenced row belongs to."},"displayColumn":{"type":"string","nullable":true,"description":"Name of the column used to display the referenced row."}},"required":["type","columnName","rowId","tableName"]},"CustomDataRow":{"type":"object","description":"A single row of a custom data table.","properties":{"id":{"type":"integer","format":"int32","description":"Unique identifier of the row within its table."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"values":{"type":"array","description":"Column values of the row, one entry per table column, in the same order\nas the columns are defined in the table.\n","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"canEdit":{"type":"boolean","description":"Whether the authenticated user is allowed to edit this row."},"canDelete":{"type":"boolean","description":"Whether the authenticated user is allowed to delete this row."},"modifiedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) of the last row modification."}},"required":["id","orgId","values","canEdit","canDelete","modifiedAt"]},"DateCustomDataColumnValue":{"type":"object","description":"Value of a date column, represented as separate day, month and year fields.","properties":{"type":{"type":"string","enum":["date"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"day":{"type":"integer","format":"int32","description":"Day of month (1-31)."},"month":{"type":"integer","format":"int32","description":"Month of year (1-12)."},"year":{"type":"integer","format":"int32","description":"Four-digit year."}},"required":["type","columnName","day","month","year"]},"NoAccessCustomDataColumnValue":{"type":"object","description":"Placeholder returned instead of the actual value when the authenticated\nuser does not have access to the underlying data of the column.\n","properties":{"type":{"type":"string","enum":["no_access"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"AggregationCustomDataColumnValue":{"type":"object","description":"Computed value of an aggregation column (e.g. sum, average over referenced rows).","properties":{"type":{"type":"string","enum":["aggregation"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed aggregated decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"RowOrganizationCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the organization a row belongs to.","properties":{"type":{"type":"string","enum":["row_organization"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"orgName":{"type":"string","nullable":true,"description":"Name of the organization the row belongs to."}},"required":["type","columnName","orgId"]},"DeviceDataSnapshotReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device data snapshot.","properties":{"type":{"type":"string","enum":["device_data_snapshot_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"snapshotId":{"type":"integer","format":"int32","description":"Identifier of the referenced snapshot."},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot started."},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot finished."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the device the snapshot belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the device the snapshot belongs to."}},"required":["type","columnName","snapshotId","startedAt","finishedAt","deviceId"]},"BooleanCustomDataColumnValue":{"type":"object","description":"Value of a boolean column.","properties":{"type":{"type":"string","enum":["boolean"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"boolean","description":"The boolean value."}},"required":["type","columnName","value"]},"DateTimeCustomDataColumnValue":{"type":"object","description":"Value of a date-time column.","properties":{"type":{"type":"string","enum":["date_time"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds)."}},"required":["type","columnName","value"]},"ListContainValueCustomDataRowFilter":{"type":"object","description":"Matches rows where the given list column contains the provided value.\n","properties":{"type":{"type":"string","enum":["list_contains"]},"listColumnName":{"type":"string","description":"Name of the list column to inspect."},"value":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"required":["type","value"]}}}}
```

## The ColumnEqualCustomDataRowFilter object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ColumnEqualCustomDataRowFilter":{"type":"object","description":"Matches rows where the given column equals the provided value. A `null`\ncolumn value matches rows where the column is empty.\n","properties":{"type":{"type":"string","enum":["column_equal"]},"value":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"required":["type","value"]},"CustomDataColumnValue":{"type":"object","description":"A single column value of a custom data table row. The concrete schema\ndepends on the `type` discriminator property, which reflects the type of\nthe column the value belongs to. Every value also carries the `columnName`\nit corresponds to.\n","discriminator":{"propertyName":"type","mapping":{"double":"#/components/schemas/DoubleCustomDataColumnValue","integer":"#/components/schemas/IntegerCustomDataColumnValue","list":"#/components/schemas/ListCustomDataColumnValue","null":"#/components/schemas/NullCustomDataColumnValue","text":"#/components/schemas/TextCustomDataColumnValue","device_reference":"#/components/schemas/DeviceReferenceCustomDataColumnValue","enum":"#/components/schemas/EnumCustomDataColumnValue","formula":"#/components/schemas/FormulaCustomDataColumnValue","created_at":"#/components/schemas/CreatedAtCustomDataColumnValue","modified_at":"#/components/schemas/ModifiedAtCustomDataColumnValue","created_by":"#/components/schemas/CreatedByCustomDataColumnValue","reference":"#/components/schemas/ReferenceCustomDataColumnValue","date":"#/components/schemas/DateCustomDataColumnValue","no_access":"#/components/schemas/NoAccessCustomDataColumnValue","aggregation":"#/components/schemas/AggregationCustomDataColumnValue","row_organization":"#/components/schemas/RowOrganizationCustomDataColumnValue","device_data_snapshot_reference":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue","boolean":"#/components/schemas/BooleanCustomDataColumnValue","date_time":"#/components/schemas/DateTimeCustomDataColumnValue"}},"oneOf":[{"$ref":"#/components/schemas/DoubleCustomDataColumnValue"},{"$ref":"#/components/schemas/IntegerCustomDataColumnValue"},{"$ref":"#/components/schemas/ListCustomDataColumnValue"},{"$ref":"#/components/schemas/NullCustomDataColumnValue"},{"$ref":"#/components/schemas/TextCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/EnumCustomDataColumnValue"},{"$ref":"#/components/schemas/FormulaCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/ModifiedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedByCustomDataColumnValue"},{"$ref":"#/components/schemas/ReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/DateCustomDataColumnValue"},{"$ref":"#/components/schemas/NoAccessCustomDataColumnValue"},{"$ref":"#/components/schemas/AggregationCustomDataColumnValue"},{"$ref":"#/components/schemas/RowOrganizationCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/BooleanCustomDataColumnValue"},{"$ref":"#/components/schemas/DateTimeCustomDataColumnValue"}]},"DoubleCustomDataColumnValue":{"type":"object","description":"Value of a decimal (double) column.","properties":{"type":{"type":"string","enum":["double"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"IntegerCustomDataColumnValue":{"type":"object","description":"Value of an integer column.","properties":{"type":{"type":"string","enum":["integer"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The integer value."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"ListCustomDataColumnValue":{"type":"object","description":"Value of a list column, holding an ordered collection of nested column values.","properties":{"type":{"type":"string","enum":["list"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"array","description":"The list items, each being a nested column value.","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}}},"required":["type","columnName","value"]},"NullCustomDataColumnValue":{"type":"object","description":"Represents an empty (unset) column value.","properties":{"type":{"type":"string","enum":["null"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"TextCustomDataColumnValue":{"type":"object","description":"Value of a text column.","properties":{"type":{"type":"string","enum":["text"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"string","nullable":true,"description":"The text value. May be `null` when the cell is empty."}},"required":["type","columnName"]},"DeviceReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device.","properties":{"type":{"type":"string","enum":["device_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the referenced device. May be `null` when no device is referenced."},"deviceOrgId":{"type":"integer","format":"int32","nullable":true,"description":"Identifier of the organization the referenced device belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the referenced device."}},"required":["type","columnName","deviceId"]},"EnumCustomDataColumnValue":{"type":"object","description":"Value of an enum column.","properties":{"type":{"type":"string","enum":["enum"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The numeric enum value, mapped to a display name in the column configuration."},"valueDisplayName":{"type":"string","nullable":true,"description":"Human-readable display name mapped to the numeric value."}},"required":["type","columnName","value"]},"FormulaCustomDataColumnValue":{"type":"object","description":"Computed value of a formula column.","properties":{"type":{"type":"string","enum":["formula"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed decimal value of the formula."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"CreatedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was created.","properties":{"type":{"type":"string","enum":["created_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was created."}},"required":["type","columnName","value"]},"ModifiedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was last modified.","properties":{"type":{"type":"string","enum":["modified_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was last modified."}},"required":["type","columnName","value"]},"CreatedByCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the user who created the row.","properties":{"type":{"type":"string","enum":["created_by"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"userId":{"type":"integer","format":"int64","description":"Identifier of the user who created the row."},"userName":{"type":"string","nullable":true,"description":"Name of the user who created the row."},"userEmail":{"type":"string","nullable":true,"description":"Email of the user who created the row."}},"required":["type","columnName","userId"]},"ReferenceCustomDataColumnValue":{"type":"object","description":"Value of a reference column that points to a row in another custom data table.","properties":{"type":{"type":"string","enum":["reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"rowId":{"type":"integer","format":"int32","description":"Identifier of the referenced row. May be `null` when no row is referenced."},"row":{"allOf":[{"$ref":"#/components/schemas/CustomDataRow"}],"nullable":true,"description":"The referenced row, resolved when references are computed."},"tableName":{"type":"string","nullable":true,"description":"Name of the table the referenced row belongs to."},"displayColumn":{"type":"string","nullable":true,"description":"Name of the column used to display the referenced row."}},"required":["type","columnName","rowId","tableName"]},"CustomDataRow":{"type":"object","description":"A single row of a custom data table.","properties":{"id":{"type":"integer","format":"int32","description":"Unique identifier of the row within its table."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"values":{"type":"array","description":"Column values of the row, one entry per table column, in the same order\nas the columns are defined in the table.\n","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"canEdit":{"type":"boolean","description":"Whether the authenticated user is allowed to edit this row."},"canDelete":{"type":"boolean","description":"Whether the authenticated user is allowed to delete this row."},"modifiedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) of the last row modification."}},"required":["id","orgId","values","canEdit","canDelete","modifiedAt"]},"DateCustomDataColumnValue":{"type":"object","description":"Value of a date column, represented as separate day, month and year fields.","properties":{"type":{"type":"string","enum":["date"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"day":{"type":"integer","format":"int32","description":"Day of month (1-31)."},"month":{"type":"integer","format":"int32","description":"Month of year (1-12)."},"year":{"type":"integer","format":"int32","description":"Four-digit year."}},"required":["type","columnName","day","month","year"]},"NoAccessCustomDataColumnValue":{"type":"object","description":"Placeholder returned instead of the actual value when the authenticated\nuser does not have access to the underlying data of the column.\n","properties":{"type":{"type":"string","enum":["no_access"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"AggregationCustomDataColumnValue":{"type":"object","description":"Computed value of an aggregation column (e.g. sum, average over referenced rows).","properties":{"type":{"type":"string","enum":["aggregation"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed aggregated decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"RowOrganizationCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the organization a row belongs to.","properties":{"type":{"type":"string","enum":["row_organization"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"orgName":{"type":"string","nullable":true,"description":"Name of the organization the row belongs to."}},"required":["type","columnName","orgId"]},"DeviceDataSnapshotReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device data snapshot.","properties":{"type":{"type":"string","enum":["device_data_snapshot_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"snapshotId":{"type":"integer","format":"int32","description":"Identifier of the referenced snapshot."},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot started."},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot finished."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the device the snapshot belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the device the snapshot belongs to."}},"required":["type","columnName","snapshotId","startedAt","finishedAt","deviceId"]},"BooleanCustomDataColumnValue":{"type":"object","description":"Value of a boolean column.","properties":{"type":{"type":"string","enum":["boolean"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"boolean","description":"The boolean value."}},"required":["type","columnName","value"]},"DateTimeCustomDataColumnValue":{"type":"object","description":"Value of a date-time column.","properties":{"type":{"type":"string","enum":["date_time"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds)."}},"required":["type","columnName","value"]}}}}
```

## The ListContainValueCustomDataRowFilter object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ListContainValueCustomDataRowFilter":{"type":"object","description":"Matches rows where the given list column contains the provided value.\n","properties":{"type":{"type":"string","enum":["list_contains"]},"listColumnName":{"type":"string","description":"Name of the list column to inspect."},"value":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"required":["type","value"]},"CustomDataColumnValue":{"type":"object","description":"A single column value of a custom data table row. The concrete schema\ndepends on the `type` discriminator property, which reflects the type of\nthe column the value belongs to. Every value also carries the `columnName`\nit corresponds to.\n","discriminator":{"propertyName":"type","mapping":{"double":"#/components/schemas/DoubleCustomDataColumnValue","integer":"#/components/schemas/IntegerCustomDataColumnValue","list":"#/components/schemas/ListCustomDataColumnValue","null":"#/components/schemas/NullCustomDataColumnValue","text":"#/components/schemas/TextCustomDataColumnValue","device_reference":"#/components/schemas/DeviceReferenceCustomDataColumnValue","enum":"#/components/schemas/EnumCustomDataColumnValue","formula":"#/components/schemas/FormulaCustomDataColumnValue","created_at":"#/components/schemas/CreatedAtCustomDataColumnValue","modified_at":"#/components/schemas/ModifiedAtCustomDataColumnValue","created_by":"#/components/schemas/CreatedByCustomDataColumnValue","reference":"#/components/schemas/ReferenceCustomDataColumnValue","date":"#/components/schemas/DateCustomDataColumnValue","no_access":"#/components/schemas/NoAccessCustomDataColumnValue","aggregation":"#/components/schemas/AggregationCustomDataColumnValue","row_organization":"#/components/schemas/RowOrganizationCustomDataColumnValue","device_data_snapshot_reference":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue","boolean":"#/components/schemas/BooleanCustomDataColumnValue","date_time":"#/components/schemas/DateTimeCustomDataColumnValue"}},"oneOf":[{"$ref":"#/components/schemas/DoubleCustomDataColumnValue"},{"$ref":"#/components/schemas/IntegerCustomDataColumnValue"},{"$ref":"#/components/schemas/ListCustomDataColumnValue"},{"$ref":"#/components/schemas/NullCustomDataColumnValue"},{"$ref":"#/components/schemas/TextCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/EnumCustomDataColumnValue"},{"$ref":"#/components/schemas/FormulaCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/ModifiedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedByCustomDataColumnValue"},{"$ref":"#/components/schemas/ReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/DateCustomDataColumnValue"},{"$ref":"#/components/schemas/NoAccessCustomDataColumnValue"},{"$ref":"#/components/schemas/AggregationCustomDataColumnValue"},{"$ref":"#/components/schemas/RowOrganizationCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/BooleanCustomDataColumnValue"},{"$ref":"#/components/schemas/DateTimeCustomDataColumnValue"}]},"DoubleCustomDataColumnValue":{"type":"object","description":"Value of a decimal (double) column.","properties":{"type":{"type":"string","enum":["double"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"IntegerCustomDataColumnValue":{"type":"object","description":"Value of an integer column.","properties":{"type":{"type":"string","enum":["integer"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The integer value."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"ListCustomDataColumnValue":{"type":"object","description":"Value of a list column, holding an ordered collection of nested column values.","properties":{"type":{"type":"string","enum":["list"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"array","description":"The list items, each being a nested column value.","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}}},"required":["type","columnName","value"]},"NullCustomDataColumnValue":{"type":"object","description":"Represents an empty (unset) column value.","properties":{"type":{"type":"string","enum":["null"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"TextCustomDataColumnValue":{"type":"object","description":"Value of a text column.","properties":{"type":{"type":"string","enum":["text"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"string","nullable":true,"description":"The text value. May be `null` when the cell is empty."}},"required":["type","columnName"]},"DeviceReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device.","properties":{"type":{"type":"string","enum":["device_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the referenced device. May be `null` when no device is referenced."},"deviceOrgId":{"type":"integer","format":"int32","nullable":true,"description":"Identifier of the organization the referenced device belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the referenced device."}},"required":["type","columnName","deviceId"]},"EnumCustomDataColumnValue":{"type":"object","description":"Value of an enum column.","properties":{"type":{"type":"string","enum":["enum"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The numeric enum value, mapped to a display name in the column configuration."},"valueDisplayName":{"type":"string","nullable":true,"description":"Human-readable display name mapped to the numeric value."}},"required":["type","columnName","value"]},"FormulaCustomDataColumnValue":{"type":"object","description":"Computed value of a formula column.","properties":{"type":{"type":"string","enum":["formula"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed decimal value of the formula."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"CreatedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was created.","properties":{"type":{"type":"string","enum":["created_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was created."}},"required":["type","columnName","value"]},"ModifiedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was last modified.","properties":{"type":{"type":"string","enum":["modified_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was last modified."}},"required":["type","columnName","value"]},"CreatedByCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the user who created the row.","properties":{"type":{"type":"string","enum":["created_by"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"userId":{"type":"integer","format":"int64","description":"Identifier of the user who created the row."},"userName":{"type":"string","nullable":true,"description":"Name of the user who created the row."},"userEmail":{"type":"string","nullable":true,"description":"Email of the user who created the row."}},"required":["type","columnName","userId"]},"ReferenceCustomDataColumnValue":{"type":"object","description":"Value of a reference column that points to a row in another custom data table.","properties":{"type":{"type":"string","enum":["reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"rowId":{"type":"integer","format":"int32","description":"Identifier of the referenced row. May be `null` when no row is referenced."},"row":{"allOf":[{"$ref":"#/components/schemas/CustomDataRow"}],"nullable":true,"description":"The referenced row, resolved when references are computed."},"tableName":{"type":"string","nullable":true,"description":"Name of the table the referenced row belongs to."},"displayColumn":{"type":"string","nullable":true,"description":"Name of the column used to display the referenced row."}},"required":["type","columnName","rowId","tableName"]},"CustomDataRow":{"type":"object","description":"A single row of a custom data table.","properties":{"id":{"type":"integer","format":"int32","description":"Unique identifier of the row within its table."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"values":{"type":"array","description":"Column values of the row, one entry per table column, in the same order\nas the columns are defined in the table.\n","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"canEdit":{"type":"boolean","description":"Whether the authenticated user is allowed to edit this row."},"canDelete":{"type":"boolean","description":"Whether the authenticated user is allowed to delete this row."},"modifiedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) of the last row modification."}},"required":["id","orgId","values","canEdit","canDelete","modifiedAt"]},"DateCustomDataColumnValue":{"type":"object","description":"Value of a date column, represented as separate day, month and year fields.","properties":{"type":{"type":"string","enum":["date"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"day":{"type":"integer","format":"int32","description":"Day of month (1-31)."},"month":{"type":"integer","format":"int32","description":"Month of year (1-12)."},"year":{"type":"integer","format":"int32","description":"Four-digit year."}},"required":["type","columnName","day","month","year"]},"NoAccessCustomDataColumnValue":{"type":"object","description":"Placeholder returned instead of the actual value when the authenticated\nuser does not have access to the underlying data of the column.\n","properties":{"type":{"type":"string","enum":["no_access"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"AggregationCustomDataColumnValue":{"type":"object","description":"Computed value of an aggregation column (e.g. sum, average over referenced rows).","properties":{"type":{"type":"string","enum":["aggregation"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed aggregated decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"RowOrganizationCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the organization a row belongs to.","properties":{"type":{"type":"string","enum":["row_organization"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"orgName":{"type":"string","nullable":true,"description":"Name of the organization the row belongs to."}},"required":["type","columnName","orgId"]},"DeviceDataSnapshotReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device data snapshot.","properties":{"type":{"type":"string","enum":["device_data_snapshot_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"snapshotId":{"type":"integer","format":"int32","description":"Identifier of the referenced snapshot."},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot started."},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot finished."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the device the snapshot belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the device the snapshot belongs to."}},"required":["type","columnName","snapshotId","startedAt","finishedAt","deviceId"]},"BooleanCustomDataColumnValue":{"type":"object","description":"Value of a boolean column.","properties":{"type":{"type":"string","enum":["boolean"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"boolean","description":"The boolean value."}},"required":["type","columnName","value"]},"DateTimeCustomDataColumnValue":{"type":"object","description":"Value of a date-time column.","properties":{"type":{"type":"string","enum":["date_time"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds)."}},"required":["type","columnName","value"]}}}}
```

## The CustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"CustomDataColumnValue":{"type":"object","description":"A single column value of a custom data table row. The concrete schema\ndepends on the `type` discriminator property, which reflects the type of\nthe column the value belongs to. Every value also carries the `columnName`\nit corresponds to.\n","discriminator":{"propertyName":"type","mapping":{"double":"#/components/schemas/DoubleCustomDataColumnValue","integer":"#/components/schemas/IntegerCustomDataColumnValue","list":"#/components/schemas/ListCustomDataColumnValue","null":"#/components/schemas/NullCustomDataColumnValue","text":"#/components/schemas/TextCustomDataColumnValue","device_reference":"#/components/schemas/DeviceReferenceCustomDataColumnValue","enum":"#/components/schemas/EnumCustomDataColumnValue","formula":"#/components/schemas/FormulaCustomDataColumnValue","created_at":"#/components/schemas/CreatedAtCustomDataColumnValue","modified_at":"#/components/schemas/ModifiedAtCustomDataColumnValue","created_by":"#/components/schemas/CreatedByCustomDataColumnValue","reference":"#/components/schemas/ReferenceCustomDataColumnValue","date":"#/components/schemas/DateCustomDataColumnValue","no_access":"#/components/schemas/NoAccessCustomDataColumnValue","aggregation":"#/components/schemas/AggregationCustomDataColumnValue","row_organization":"#/components/schemas/RowOrganizationCustomDataColumnValue","device_data_snapshot_reference":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue","boolean":"#/components/schemas/BooleanCustomDataColumnValue","date_time":"#/components/schemas/DateTimeCustomDataColumnValue"}},"oneOf":[{"$ref":"#/components/schemas/DoubleCustomDataColumnValue"},{"$ref":"#/components/schemas/IntegerCustomDataColumnValue"},{"$ref":"#/components/schemas/ListCustomDataColumnValue"},{"$ref":"#/components/schemas/NullCustomDataColumnValue"},{"$ref":"#/components/schemas/TextCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/EnumCustomDataColumnValue"},{"$ref":"#/components/schemas/FormulaCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/ModifiedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedByCustomDataColumnValue"},{"$ref":"#/components/schemas/ReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/DateCustomDataColumnValue"},{"$ref":"#/components/schemas/NoAccessCustomDataColumnValue"},{"$ref":"#/components/schemas/AggregationCustomDataColumnValue"},{"$ref":"#/components/schemas/RowOrganizationCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/BooleanCustomDataColumnValue"},{"$ref":"#/components/schemas/DateTimeCustomDataColumnValue"}]},"DoubleCustomDataColumnValue":{"type":"object","description":"Value of a decimal (double) column.","properties":{"type":{"type":"string","enum":["double"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"IntegerCustomDataColumnValue":{"type":"object","description":"Value of an integer column.","properties":{"type":{"type":"string","enum":["integer"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The integer value."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"ListCustomDataColumnValue":{"type":"object","description":"Value of a list column, holding an ordered collection of nested column values.","properties":{"type":{"type":"string","enum":["list"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"array","description":"The list items, each being a nested column value.","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}}},"required":["type","columnName","value"]},"NullCustomDataColumnValue":{"type":"object","description":"Represents an empty (unset) column value.","properties":{"type":{"type":"string","enum":["null"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"TextCustomDataColumnValue":{"type":"object","description":"Value of a text column.","properties":{"type":{"type":"string","enum":["text"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"string","nullable":true,"description":"The text value. May be `null` when the cell is empty."}},"required":["type","columnName"]},"DeviceReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device.","properties":{"type":{"type":"string","enum":["device_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the referenced device. May be `null` when no device is referenced."},"deviceOrgId":{"type":"integer","format":"int32","nullable":true,"description":"Identifier of the organization the referenced device belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the referenced device."}},"required":["type","columnName","deviceId"]},"EnumCustomDataColumnValue":{"type":"object","description":"Value of an enum column.","properties":{"type":{"type":"string","enum":["enum"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The numeric enum value, mapped to a display name in the column configuration."},"valueDisplayName":{"type":"string","nullable":true,"description":"Human-readable display name mapped to the numeric value."}},"required":["type","columnName","value"]},"FormulaCustomDataColumnValue":{"type":"object","description":"Computed value of a formula column.","properties":{"type":{"type":"string","enum":["formula"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed decimal value of the formula."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"CreatedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was created.","properties":{"type":{"type":"string","enum":["created_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was created."}},"required":["type","columnName","value"]},"ModifiedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was last modified.","properties":{"type":{"type":"string","enum":["modified_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was last modified."}},"required":["type","columnName","value"]},"CreatedByCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the user who created the row.","properties":{"type":{"type":"string","enum":["created_by"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"userId":{"type":"integer","format":"int64","description":"Identifier of the user who created the row."},"userName":{"type":"string","nullable":true,"description":"Name of the user who created the row."},"userEmail":{"type":"string","nullable":true,"description":"Email of the user who created the row."}},"required":["type","columnName","userId"]},"ReferenceCustomDataColumnValue":{"type":"object","description":"Value of a reference column that points to a row in another custom data table.","properties":{"type":{"type":"string","enum":["reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"rowId":{"type":"integer","format":"int32","description":"Identifier of the referenced row. May be `null` when no row is referenced."},"row":{"allOf":[{"$ref":"#/components/schemas/CustomDataRow"}],"nullable":true,"description":"The referenced row, resolved when references are computed."},"tableName":{"type":"string","nullable":true,"description":"Name of the table the referenced row belongs to."},"displayColumn":{"type":"string","nullable":true,"description":"Name of the column used to display the referenced row."}},"required":["type","columnName","rowId","tableName"]},"CustomDataRow":{"type":"object","description":"A single row of a custom data table.","properties":{"id":{"type":"integer","format":"int32","description":"Unique identifier of the row within its table."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"values":{"type":"array","description":"Column values of the row, one entry per table column, in the same order\nas the columns are defined in the table.\n","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"canEdit":{"type":"boolean","description":"Whether the authenticated user is allowed to edit this row."},"canDelete":{"type":"boolean","description":"Whether the authenticated user is allowed to delete this row."},"modifiedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) of the last row modification."}},"required":["id","orgId","values","canEdit","canDelete","modifiedAt"]},"DateCustomDataColumnValue":{"type":"object","description":"Value of a date column, represented as separate day, month and year fields.","properties":{"type":{"type":"string","enum":["date"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"day":{"type":"integer","format":"int32","description":"Day of month (1-31)."},"month":{"type":"integer","format":"int32","description":"Month of year (1-12)."},"year":{"type":"integer","format":"int32","description":"Four-digit year."}},"required":["type","columnName","day","month","year"]},"NoAccessCustomDataColumnValue":{"type":"object","description":"Placeholder returned instead of the actual value when the authenticated\nuser does not have access to the underlying data of the column.\n","properties":{"type":{"type":"string","enum":["no_access"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"AggregationCustomDataColumnValue":{"type":"object","description":"Computed value of an aggregation column (e.g. sum, average over referenced rows).","properties":{"type":{"type":"string","enum":["aggregation"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed aggregated decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"RowOrganizationCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the organization a row belongs to.","properties":{"type":{"type":"string","enum":["row_organization"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"orgName":{"type":"string","nullable":true,"description":"Name of the organization the row belongs to."}},"required":["type","columnName","orgId"]},"DeviceDataSnapshotReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device data snapshot.","properties":{"type":{"type":"string","enum":["device_data_snapshot_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"snapshotId":{"type":"integer","format":"int32","description":"Identifier of the referenced snapshot."},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot started."},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot finished."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the device the snapshot belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the device the snapshot belongs to."}},"required":["type","columnName","snapshotId","startedAt","finishedAt","deviceId"]},"BooleanCustomDataColumnValue":{"type":"object","description":"Value of a boolean column.","properties":{"type":{"type":"string","enum":["boolean"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"boolean","description":"The boolean value."}},"required":["type","columnName","value"]},"DateTimeCustomDataColumnValue":{"type":"object","description":"Value of a date-time column.","properties":{"type":{"type":"string","enum":["date_time"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds)."}},"required":["type","columnName","value"]}}}}
```

## The TextCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"TextCustomDataColumnValue":{"type":"object","description":"Value of a text column.","properties":{"type":{"type":"string","enum":["text"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"string","nullable":true,"description":"The text value. May be `null` when the cell is empty."}},"required":["type","columnName"]}}}}
```

## The IntegerCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"IntegerCustomDataColumnValue":{"type":"object","description":"Value of an integer column.","properties":{"type":{"type":"string","enum":["integer"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The integer value."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]}}}}
```

## The DoubleCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DoubleCustomDataColumnValue":{"type":"object","description":"Value of a decimal (double) column.","properties":{"type":{"type":"string","enum":["double"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]}}}}
```

## The BooleanCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"BooleanCustomDataColumnValue":{"type":"object","description":"Value of a boolean column.","properties":{"type":{"type":"string","enum":["boolean"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"boolean","description":"The boolean value."}},"required":["type","columnName","value"]}}}}
```

## The DateCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DateCustomDataColumnValue":{"type":"object","description":"Value of a date column, represented as separate day, month and year fields.","properties":{"type":{"type":"string","enum":["date"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"day":{"type":"integer","format":"int32","description":"Day of month (1-31)."},"month":{"type":"integer","format":"int32","description":"Month of year (1-12)."},"year":{"type":"integer","format":"int32","description":"Four-digit year."}},"required":["type","columnName","day","month","year"]}}}}
```

## The DateTimeCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DateTimeCustomDataColumnValue":{"type":"object","description":"Value of a date-time column.","properties":{"type":{"type":"string","enum":["date_time"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds)."}},"required":["type","columnName","value"]}}}}
```

## The CreatedAtCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"CreatedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was created.","properties":{"type":{"type":"string","enum":["created_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was created."}},"required":["type","columnName","value"]}}}}
```

## The ModifiedAtCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ModifiedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was last modified.","properties":{"type":{"type":"string","enum":["modified_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was last modified."}},"required":["type","columnName","value"]}}}}
```

## The CreatedByCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"CreatedByCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the user who created the row.","properties":{"type":{"type":"string","enum":["created_by"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"userId":{"type":"integer","format":"int64","description":"Identifier of the user who created the row."},"userName":{"type":"string","nullable":true,"description":"Name of the user who created the row."},"userEmail":{"type":"string","nullable":true,"description":"Email of the user who created the row."}},"required":["type","columnName","userId"]}}}}
```

## The EnumCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"EnumCustomDataColumnValue":{"type":"object","description":"Value of an enum column.","properties":{"type":{"type":"string","enum":["enum"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The numeric enum value, mapped to a display name in the column configuration."},"valueDisplayName":{"type":"string","nullable":true,"description":"Human-readable display name mapped to the numeric value."}},"required":["type","columnName","value"]}}}}
```

## The FormulaCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"FormulaCustomDataColumnValue":{"type":"object","description":"Computed value of a formula column.","properties":{"type":{"type":"string","enum":["formula"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed decimal value of the formula."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]}}}}
```

## The AggregationCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"AggregationCustomDataColumnValue":{"type":"object","description":"Computed value of an aggregation column (e.g. sum, average over referenced rows).","properties":{"type":{"type":"string","enum":["aggregation"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed aggregated decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]}}}}
```

## The ListCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ListCustomDataColumnValue":{"type":"object","description":"Value of a list column, holding an ordered collection of nested column values.","properties":{"type":{"type":"string","enum":["list"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"array","description":"The list items, each being a nested column value.","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}}},"required":["type","columnName","value"]},"CustomDataColumnValue":{"type":"object","description":"A single column value of a custom data table row. The concrete schema\ndepends on the `type` discriminator property, which reflects the type of\nthe column the value belongs to. Every value also carries the `columnName`\nit corresponds to.\n","discriminator":{"propertyName":"type","mapping":{"double":"#/components/schemas/DoubleCustomDataColumnValue","integer":"#/components/schemas/IntegerCustomDataColumnValue","list":"#/components/schemas/ListCustomDataColumnValue","null":"#/components/schemas/NullCustomDataColumnValue","text":"#/components/schemas/TextCustomDataColumnValue","device_reference":"#/components/schemas/DeviceReferenceCustomDataColumnValue","enum":"#/components/schemas/EnumCustomDataColumnValue","formula":"#/components/schemas/FormulaCustomDataColumnValue","created_at":"#/components/schemas/CreatedAtCustomDataColumnValue","modified_at":"#/components/schemas/ModifiedAtCustomDataColumnValue","created_by":"#/components/schemas/CreatedByCustomDataColumnValue","reference":"#/components/schemas/ReferenceCustomDataColumnValue","date":"#/components/schemas/DateCustomDataColumnValue","no_access":"#/components/schemas/NoAccessCustomDataColumnValue","aggregation":"#/components/schemas/AggregationCustomDataColumnValue","row_organization":"#/components/schemas/RowOrganizationCustomDataColumnValue","device_data_snapshot_reference":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue","boolean":"#/components/schemas/BooleanCustomDataColumnValue","date_time":"#/components/schemas/DateTimeCustomDataColumnValue"}},"oneOf":[{"$ref":"#/components/schemas/DoubleCustomDataColumnValue"},{"$ref":"#/components/schemas/IntegerCustomDataColumnValue"},{"$ref":"#/components/schemas/ListCustomDataColumnValue"},{"$ref":"#/components/schemas/NullCustomDataColumnValue"},{"$ref":"#/components/schemas/TextCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/EnumCustomDataColumnValue"},{"$ref":"#/components/schemas/FormulaCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/ModifiedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedByCustomDataColumnValue"},{"$ref":"#/components/schemas/ReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/DateCustomDataColumnValue"},{"$ref":"#/components/schemas/NoAccessCustomDataColumnValue"},{"$ref":"#/components/schemas/AggregationCustomDataColumnValue"},{"$ref":"#/components/schemas/RowOrganizationCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/BooleanCustomDataColumnValue"},{"$ref":"#/components/schemas/DateTimeCustomDataColumnValue"}]},"DoubleCustomDataColumnValue":{"type":"object","description":"Value of a decimal (double) column.","properties":{"type":{"type":"string","enum":["double"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"IntegerCustomDataColumnValue":{"type":"object","description":"Value of an integer column.","properties":{"type":{"type":"string","enum":["integer"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The integer value."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"NullCustomDataColumnValue":{"type":"object","description":"Represents an empty (unset) column value.","properties":{"type":{"type":"string","enum":["null"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"TextCustomDataColumnValue":{"type":"object","description":"Value of a text column.","properties":{"type":{"type":"string","enum":["text"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"string","nullable":true,"description":"The text value. May be `null` when the cell is empty."}},"required":["type","columnName"]},"DeviceReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device.","properties":{"type":{"type":"string","enum":["device_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the referenced device. May be `null` when no device is referenced."},"deviceOrgId":{"type":"integer","format":"int32","nullable":true,"description":"Identifier of the organization the referenced device belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the referenced device."}},"required":["type","columnName","deviceId"]},"EnumCustomDataColumnValue":{"type":"object","description":"Value of an enum column.","properties":{"type":{"type":"string","enum":["enum"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The numeric enum value, mapped to a display name in the column configuration."},"valueDisplayName":{"type":"string","nullable":true,"description":"Human-readable display name mapped to the numeric value."}},"required":["type","columnName","value"]},"FormulaCustomDataColumnValue":{"type":"object","description":"Computed value of a formula column.","properties":{"type":{"type":"string","enum":["formula"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed decimal value of the formula."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"CreatedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was created.","properties":{"type":{"type":"string","enum":["created_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was created."}},"required":["type","columnName","value"]},"ModifiedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was last modified.","properties":{"type":{"type":"string","enum":["modified_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was last modified."}},"required":["type","columnName","value"]},"CreatedByCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the user who created the row.","properties":{"type":{"type":"string","enum":["created_by"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"userId":{"type":"integer","format":"int64","description":"Identifier of the user who created the row."},"userName":{"type":"string","nullable":true,"description":"Name of the user who created the row."},"userEmail":{"type":"string","nullable":true,"description":"Email of the user who created the row."}},"required":["type","columnName","userId"]},"ReferenceCustomDataColumnValue":{"type":"object","description":"Value of a reference column that points to a row in another custom data table.","properties":{"type":{"type":"string","enum":["reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"rowId":{"type":"integer","format":"int32","description":"Identifier of the referenced row. May be `null` when no row is referenced."},"row":{"allOf":[{"$ref":"#/components/schemas/CustomDataRow"}],"nullable":true,"description":"The referenced row, resolved when references are computed."},"tableName":{"type":"string","nullable":true,"description":"Name of the table the referenced row belongs to."},"displayColumn":{"type":"string","nullable":true,"description":"Name of the column used to display the referenced row."}},"required":["type","columnName","rowId","tableName"]},"CustomDataRow":{"type":"object","description":"A single row of a custom data table.","properties":{"id":{"type":"integer","format":"int32","description":"Unique identifier of the row within its table."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"values":{"type":"array","description":"Column values of the row, one entry per table column, in the same order\nas the columns are defined in the table.\n","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"canEdit":{"type":"boolean","description":"Whether the authenticated user is allowed to edit this row."},"canDelete":{"type":"boolean","description":"Whether the authenticated user is allowed to delete this row."},"modifiedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) of the last row modification."}},"required":["id","orgId","values","canEdit","canDelete","modifiedAt"]},"DateCustomDataColumnValue":{"type":"object","description":"Value of a date column, represented as separate day, month and year fields.","properties":{"type":{"type":"string","enum":["date"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"day":{"type":"integer","format":"int32","description":"Day of month (1-31)."},"month":{"type":"integer","format":"int32","description":"Month of year (1-12)."},"year":{"type":"integer","format":"int32","description":"Four-digit year."}},"required":["type","columnName","day","month","year"]},"NoAccessCustomDataColumnValue":{"type":"object","description":"Placeholder returned instead of the actual value when the authenticated\nuser does not have access to the underlying data of the column.\n","properties":{"type":{"type":"string","enum":["no_access"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"AggregationCustomDataColumnValue":{"type":"object","description":"Computed value of an aggregation column (e.g. sum, average over referenced rows).","properties":{"type":{"type":"string","enum":["aggregation"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed aggregated decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"RowOrganizationCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the organization a row belongs to.","properties":{"type":{"type":"string","enum":["row_organization"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"orgName":{"type":"string","nullable":true,"description":"Name of the organization the row belongs to."}},"required":["type","columnName","orgId"]},"DeviceDataSnapshotReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device data snapshot.","properties":{"type":{"type":"string","enum":["device_data_snapshot_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"snapshotId":{"type":"integer","format":"int32","description":"Identifier of the referenced snapshot."},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot started."},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot finished."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the device the snapshot belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the device the snapshot belongs to."}},"required":["type","columnName","snapshotId","startedAt","finishedAt","deviceId"]},"BooleanCustomDataColumnValue":{"type":"object","description":"Value of a boolean column.","properties":{"type":{"type":"string","enum":["boolean"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"boolean","description":"The boolean value."}},"required":["type","columnName","value"]},"DateTimeCustomDataColumnValue":{"type":"object","description":"Value of a date-time column.","properties":{"type":{"type":"string","enum":["date_time"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds)."}},"required":["type","columnName","value"]}}}}
```

## The ReferenceCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"ReferenceCustomDataColumnValue":{"type":"object","description":"Value of a reference column that points to a row in another custom data table.","properties":{"type":{"type":"string","enum":["reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"rowId":{"type":"integer","format":"int32","description":"Identifier of the referenced row. May be `null` when no row is referenced."},"row":{"allOf":[{"$ref":"#/components/schemas/CustomDataRow"}],"nullable":true,"description":"The referenced row, resolved when references are computed."},"tableName":{"type":"string","nullable":true,"description":"Name of the table the referenced row belongs to."},"displayColumn":{"type":"string","nullable":true,"description":"Name of the column used to display the referenced row."}},"required":["type","columnName","rowId","tableName"]},"CustomDataRow":{"type":"object","description":"A single row of a custom data table.","properties":{"id":{"type":"integer","format":"int32","description":"Unique identifier of the row within its table."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"values":{"type":"array","description":"Column values of the row, one entry per table column, in the same order\nas the columns are defined in the table.\n","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}},"canEdit":{"type":"boolean","description":"Whether the authenticated user is allowed to edit this row."},"canDelete":{"type":"boolean","description":"Whether the authenticated user is allowed to delete this row."},"modifiedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) of the last row modification."}},"required":["id","orgId","values","canEdit","canDelete","modifiedAt"]},"CustomDataColumnValue":{"type":"object","description":"A single column value of a custom data table row. The concrete schema\ndepends on the `type` discriminator property, which reflects the type of\nthe column the value belongs to. Every value also carries the `columnName`\nit corresponds to.\n","discriminator":{"propertyName":"type","mapping":{"double":"#/components/schemas/DoubleCustomDataColumnValue","integer":"#/components/schemas/IntegerCustomDataColumnValue","list":"#/components/schemas/ListCustomDataColumnValue","null":"#/components/schemas/NullCustomDataColumnValue","text":"#/components/schemas/TextCustomDataColumnValue","device_reference":"#/components/schemas/DeviceReferenceCustomDataColumnValue","enum":"#/components/schemas/EnumCustomDataColumnValue","formula":"#/components/schemas/FormulaCustomDataColumnValue","created_at":"#/components/schemas/CreatedAtCustomDataColumnValue","modified_at":"#/components/schemas/ModifiedAtCustomDataColumnValue","created_by":"#/components/schemas/CreatedByCustomDataColumnValue","reference":"#/components/schemas/ReferenceCustomDataColumnValue","date":"#/components/schemas/DateCustomDataColumnValue","no_access":"#/components/schemas/NoAccessCustomDataColumnValue","aggregation":"#/components/schemas/AggregationCustomDataColumnValue","row_organization":"#/components/schemas/RowOrganizationCustomDataColumnValue","device_data_snapshot_reference":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue","boolean":"#/components/schemas/BooleanCustomDataColumnValue","date_time":"#/components/schemas/DateTimeCustomDataColumnValue"}},"oneOf":[{"$ref":"#/components/schemas/DoubleCustomDataColumnValue"},{"$ref":"#/components/schemas/IntegerCustomDataColumnValue"},{"$ref":"#/components/schemas/ListCustomDataColumnValue"},{"$ref":"#/components/schemas/NullCustomDataColumnValue"},{"$ref":"#/components/schemas/TextCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/EnumCustomDataColumnValue"},{"$ref":"#/components/schemas/FormulaCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/ModifiedAtCustomDataColumnValue"},{"$ref":"#/components/schemas/CreatedByCustomDataColumnValue"},{"$ref":"#/components/schemas/ReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/DateCustomDataColumnValue"},{"$ref":"#/components/schemas/NoAccessCustomDataColumnValue"},{"$ref":"#/components/schemas/AggregationCustomDataColumnValue"},{"$ref":"#/components/schemas/RowOrganizationCustomDataColumnValue"},{"$ref":"#/components/schemas/DeviceDataSnapshotReferenceCustomDataColumnValue"},{"$ref":"#/components/schemas/BooleanCustomDataColumnValue"},{"$ref":"#/components/schemas/DateTimeCustomDataColumnValue"}]},"DoubleCustomDataColumnValue":{"type":"object","description":"Value of a decimal (double) column.","properties":{"type":{"type":"string","enum":["double"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"DecimalsFormat":{"type":"string","description":"Decimal format used for displaying a numeric value in the dashboard and reports.\n","enum":["NO_FRACTION","FRACTION_1","FRACTION_2","FRACTION_3","FRACTION_4","FRACTION_5","FILL_1","FILL_2","FILL_3","FILL_4","FILL_5"]},"MeasurementUnits":{"type":"string","description":"DataStream units","enum":["None","KilometerPerHour","MillimeterPerHour","InchesPerHour","CubicMetresPerHour","MilePerHour","MilePerHour2","GramPerSquareMeter","MilliLitterPerSquareMeter","LitterPerSquareMeter","PoundPerSquareInch","PoundPerSquareInch2","PoundPerCubicYard","OuncePerCubicYard","PoundPerCubicFoot","VolumeFlow","CubicCentimetersPerMinute","SignalStrength","DegreeDays","Millimeter","Centimeter","Meter","Kilometer","KiloBytes","MegaBytes","GigaBytes","Feet","SquareFeet","Inch","Foot","Yard","Mile","Milligram","Gram","Kilogram","Ton","Liter","Milliliter","Ounce","Pint","Gallon","Pound","Stone","Quarter","Hundredweight","Celsius","Fahrenheit","Kelvin","Percentage","Degrees","RPM","Step","Year","Month","Week","Day","Hour","Minute","Second","Volt","Ampere","MilliAmpere","MicroAmpere","Ohm","Hertz","Watts","Farad","Siemen","Henry","MicrogramPerCubicMeter","PartsPerMillion","PartsPerBillion","KiloWatts","HectoPascal","Pascal","Lux","Pressure","PressureInBars","AirQualityIndex","KiloWattHour","MilliSecond","MilliSec","MeterPerSecond","MilliGramPerCubicMeter","KiloPascal","CubicMeter","CubicYard","CubicFeetPerMinute","SquareMeter","LitersPerSecond","WattHour","MilliWatt","pH","AmpereHour","MilliAmpereHour"]},"IntegerCustomDataColumnValue":{"type":"object","description":"Value of an integer column.","properties":{"type":{"type":"string","enum":["integer"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The integer value."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"ListCustomDataColumnValue":{"type":"object","description":"Value of a list column, holding an ordered collection of nested column values.","properties":{"type":{"type":"string","enum":["list"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"array","description":"The list items, each being a nested column value.","items":{"$ref":"#/components/schemas/CustomDataColumnValue"}}},"required":["type","columnName","value"]},"NullCustomDataColumnValue":{"type":"object","description":"Represents an empty (unset) column value.","properties":{"type":{"type":"string","enum":["null"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"TextCustomDataColumnValue":{"type":"object","description":"Value of a text column.","properties":{"type":{"type":"string","enum":["text"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"string","nullable":true,"description":"The text value. May be `null` when the cell is empty."}},"required":["type","columnName"]},"DeviceReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device.","properties":{"type":{"type":"string","enum":["device_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the referenced device. May be `null` when no device is referenced."},"deviceOrgId":{"type":"integer","format":"int32","nullable":true,"description":"Identifier of the organization the referenced device belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the referenced device."}},"required":["type","columnName","deviceId"]},"EnumCustomDataColumnValue":{"type":"object","description":"Value of an enum column.","properties":{"type":{"type":"string","enum":["enum"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int32","description":"The numeric enum value, mapped to a display name in the column configuration."},"valueDisplayName":{"type":"string","nullable":true,"description":"Human-readable display name mapped to the numeric value."}},"required":["type","columnName","value"]},"FormulaCustomDataColumnValue":{"type":"object","description":"Computed value of a formula column.","properties":{"type":{"type":"string","enum":["formula"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed decimal value of the formula."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"CreatedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was created.","properties":{"type":{"type":"string","enum":["created_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was created."}},"required":["type","columnName","value"]},"ModifiedAtCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores when the row was last modified.","properties":{"type":{"type":"string","enum":["modified_at"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the row was last modified."}},"required":["type","columnName","value"]},"CreatedByCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the user who created the row.","properties":{"type":{"type":"string","enum":["created_by"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"userId":{"type":"integer","format":"int64","description":"Identifier of the user who created the row."},"userName":{"type":"string","nullable":true,"description":"Name of the user who created the row."},"userEmail":{"type":"string","nullable":true,"description":"Email of the user who created the row."}},"required":["type","columnName","userId"]},"DateCustomDataColumnValue":{"type":"object","description":"Value of a date column, represented as separate day, month and year fields.","properties":{"type":{"type":"string","enum":["date"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"day":{"type":"integer","format":"int32","description":"Day of month (1-31)."},"month":{"type":"integer","format":"int32","description":"Month of year (1-12)."},"year":{"type":"integer","format":"int32","description":"Four-digit year."}},"required":["type","columnName","day","month","year"]},"NoAccessCustomDataColumnValue":{"type":"object","description":"Placeholder returned instead of the actual value when the authenticated\nuser does not have access to the underlying data of the column.\n","properties":{"type":{"type":"string","enum":["no_access"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]},"AggregationCustomDataColumnValue":{"type":"object","description":"Computed value of an aggregation column (e.g. sum, average over referenced rows).","properties":{"type":{"type":"string","enum":["aggregation"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"number","format":"double","description":"The computed aggregated decimal value."},"decimalsFormat":{"allOf":[{"$ref":"#/components/schemas/DecimalsFormat"}],"nullable":true,"description":"Decimal format configured for the column, when present."},"unit":{"allOf":[{"$ref":"#/components/schemas/MeasurementUnits"}],"nullable":true,"description":"Measurement unit of the value, when configured for the column."}},"required":["type","columnName","value"]},"RowOrganizationCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the organization a row belongs to.","properties":{"type":{"type":"string","enum":["row_organization"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"orgName":{"type":"string","nullable":true,"description":"Name of the organization the row belongs to."}},"required":["type","columnName","orgId"]},"DeviceDataSnapshotReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device data snapshot.","properties":{"type":{"type":"string","enum":["device_data_snapshot_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"snapshotId":{"type":"integer","format":"int32","description":"Identifier of the referenced snapshot."},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot started."},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot finished."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the device the snapshot belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the device the snapshot belongs to."}},"required":["type","columnName","snapshotId","startedAt","finishedAt","deviceId"]},"BooleanCustomDataColumnValue":{"type":"object","description":"Value of a boolean column.","properties":{"type":{"type":"string","enum":["boolean"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"boolean","description":"The boolean value."}},"required":["type","columnName","value"]},"DateTimeCustomDataColumnValue":{"type":"object","description":"Value of a date-time column.","properties":{"type":{"type":"string","enum":["date_time"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"value":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds)."}},"required":["type","columnName","value"]}}}}
```

## The DeviceReferenceCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device.","properties":{"type":{"type":"string","enum":["device_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the referenced device. May be `null` when no device is referenced."},"deviceOrgId":{"type":"integer","format":"int32","nullable":true,"description":"Identifier of the organization the referenced device belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the referenced device."}},"required":["type","columnName","deviceId"]}}}}
```

## The DeviceDataSnapshotReferenceCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"DeviceDataSnapshotReferenceCustomDataColumnValue":{"type":"object","description":"Value of a column that references a device data snapshot.","properties":{"type":{"type":"string","enum":["device_data_snapshot_reference"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"snapshotId":{"type":"integer","format":"int32","description":"Identifier of the referenced snapshot."},"startedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot started."},"finishedAt":{"type":"integer","format":"int64","description":"Timestamp (Unix epoch milliseconds) when the snapshot finished."},"deviceId":{"type":"integer","format":"int32","description":"Identifier of the device the snapshot belongs to."},"deviceName":{"type":"string","nullable":true,"description":"Name of the device the snapshot belongs to."}},"required":["type","columnName","snapshotId","startedAt","finishedAt","deviceId"]}}}}
```

## The RowOrganizationCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"RowOrganizationCustomDataColumnValue":{"type":"object","description":"Value of a system column that stores the organization a row belongs to.","properties":{"type":{"type":"string","enum":["row_organization"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."},"orgId":{"type":"integer","format":"int32","description":"Identifier of the organization the row belongs to."},"orgName":{"type":"string","nullable":true,"description":"Name of the organization the row belongs to."}},"required":["type","columnName","orgId"]}}}}
```

## The NullCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"NullCustomDataColumnValue":{"type":"object","description":"Represents an empty (unset) column value.","properties":{"type":{"type":"string","enum":["null"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]}}}}
```

## The NoAccessCustomDataColumnValue object

```json
{"openapi":"3.0.3","info":{"title":"Blynk Platform API","version":"1.0.0"},"components":{"schemas":{"NoAccessCustomDataColumnValue":{"type":"object","description":"Placeholder returned instead of the actual value when the authenticated\nuser does not have access to the underlying data of the column.\n","properties":{"type":{"type":"string","enum":["no_access"],"description":"Value type discriminator."},"columnName":{"type":"string","description":"Name of the column this value belongs to."}},"required":["type","columnName"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.blynk.io/en/blynk.cloud/platform-https-api/models.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
