create: projects.locations.registries.devices
- Aaron Allsbrook
- Jeff Slavin (Unlicensed)
- Akash Sharma
Creates a device in a device registry.
Note: This is a regional API.
You can find the URL, SystemKey, and token required in the call by clicking API Keys (key icon) at the top-right of the Registry Details page. Use the Registry Keys section.
HTTP request
POST {URL}/api/v/4/webhook/execute/{SystemKey}/cloudiot_devices
Query parameters
None
Header parameters
Parameters | |
|---|---|
| See the note at the start of this document on where to find the token. |
Request body
The request body contains a device instance.
Response status codes
Code | Meaning |
|---|---|
200 | Success |
Response body
If successful, the response body contains a newly created device instance.
Example curl
curl 'https://us-central1.clearblade.com/api/v/4/webhook/execute/aae9b9b30c8aa4e49081c7eeb9bb07/cloudiot_devices' -X POST -H 'ClearBlade-UserToken: {Token}' -d '{"id": "test-device-1", "credentials": [], "config": {}, "metadata": {}, "logLevel": "LOG_LEVEL_UNSPECIFIED"}'
Using the instructions at the start of this document, replace the following: https://us-central1.clearblade.com with your URL. aae9b9b30c8aa4e49081c7eeb9bb07 with your SystemKey. {Token} with your token.
The item id is required in the body. If other items are not provided, they will have default values in the created device. Set the values of id and other items appropriately.