# 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_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_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"}},"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"}}}}}}
```

## 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":"Path to the firmware file on the server"},"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 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"]}}}}
```


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.