create

Creates a device registry.

Note: This is an admin API.

The URL, systemKey, and token this endpoint requires are obtained differently than others. To get those, do the following:

Click the Select project drop-down at the top of the IoT Core UI.
Click the Edit icon (pencil) next to the desired project.
Go to the SERVICE ACCOUNTS tab.
If a service account already exists, select it and choose DOWNLOAD CREDENTIALS. If a service account does not exist, create it and select DOWNLOAD CREDENTIALS.
A JSON file will be downloaded to your local machine. Open the file with an editor. Use the systemKey, token, and URL from the file as needed below.

HTTP request

POST {url}/api/v/4/webhook/execute/{systemKey}/cloudiot

Query parameters

Parameters

Parameters

parent

string

The project and cloud region path. For example, projects/example-project/locations/us-central1.

Header parameters

Parameters

Parameters
`ClearBlade-UserToken`	See the note at the start of this document on where to find the token.

Request body

The request body contains a DeviceRegistry instance.

Response status codes

Code	Meaning

Code	Meaning
200	Success

Response body

If successful, the response body contains a newly created DeviceRegistry instance.

Example curl

curl 'https://iot.clearblade.com/api/v/4/webhook/execute/aae9b9b30c8aa4e49081c7eeb9bb07/cloudiot?parent=projects/iot-core-test-363819/locations/us-central1' -H 'ClearBlade-UserToken: {token}' -d '{ "id": "two", "eventNotificationConfigs": [], stateNotificationConfig": {}, "mqttConfig": {}, "httpConfig": {}, "logLevel": "NONE", "credentials": [] }'

Using the instructions at the start of this document, replace the following: https://iot.clearblade.com with your URL. aae9b9b30c8aa4e49081c7eeb9bb07 with your systemKey. {token} with your token.

This example’s body contains a registry object with name and id “two.” Replace the registry object with your own.