{"type":"api","title":"Write a BLE Device","meta":{"id":"/apps/pubhub/media/spaces-connect-for-iot-services/65e3122122594f77317aed6de8fe860864ee18aa/fe185569-32c7-3a71-a7db-7b18e6f0f371","info":{"version":"1.1.0","title":"IoT Nova NIPC APIs"},"x-parser-conf":{"overview":{"markdownPath":"reference/overview-control.md"}},"openapi":"3.0.0"},"spec":{"summary":"Write a BLE Device","operationId":"writeDevice","tags":["Data APIs"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"technology":{"type":"string","description":"Specifies the wireless technology used; for Sensor Connect BLE use cases, this will be `ble` indicating Bluetooth Low Energy.","example":"ble"},"id":{"type":"string","description":"A unique identifier for the device in UUID format, obtained as a response when the device is onboarded using the SCIM API.","example":"5ae0c228-24c9-433c-9001-5a23f063ffd0"},"controlApp":{"type":"string","description":"Represents the control application instance that manages the BLE device interactions through Sensor Connect. This value is specified during device onboarding using the SCIM API to indicate the application authorized to perform control operations on the device.","example":"controlApplication","$$ref":"#/components/schemas/ControlAppProperty"},"ble":{"type":"object","properties":{"serviceID":{"type":"string","description":"The unique identifier (UUID) of a specific BLE service on the device.","example":"1800","$$ref":"#/components/schemas/BleServiceID"},"characteristicID":{"type":"string","description":"The unique identifier (UUID) of a specific characteristic within a BLE service, representing a data point or control feature.","example":"2A5E","$$ref":"#/components/schemas/BleCharacteristicID"}},"required":["serviceID","characteristicID"]},"value":{"type":"string","description":"The data payload to be written to the specified BLE characteristic.","example":"0001"}},"required":["technology","id","controlApp","ble","value"],"$$ref":"#/components/schemas/BLECharacteristicRequest","description":"Writes data or commands to a specific GATT characteristic on the BLE device."}}}},"parameters":[{"name":"x-api-key","in":"header","required":true,"schema":{"type":"string"},"example":"8506a7e0c4242b9091bde6735dedb41f"}],"responses":{"200":{"description":"Device write successful","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"Indicates the outcome of the API operation (e.g., 'SUCCESS', 'FAILURE').","example":"SUCCESS"},"id":{"type":"string","description":"A unique identifier for the device in UUID format, obtained as a response when the device is onboarded using the SCIM API.","example":"5ae0c228-24c9-433c-9001-5a23f063ffd0"},"requestID":{"type":"string","description":"A unique identifier for the specific API request, useful for tracking and debugging.","example":"ebfd7e14-d4b7-4aa4-97f9-2dfaffed7c08"}},"$$ref":"#/components/schemas/CommonStatusResponse"}}}}},"__originalOperationId":"writeDevice","method":"post","path":"/control/data/write"}}