GOgolioth
Devices

Create a new device

Changed on

Create a new device with a unique name in an existing project. The tags, blueprint and cohort must already have been created.

If no hardware ID is specified, a new hardware ID is generated. The device will also be assigned a unique device ID that can be used to fetch it later.

post/v1/projects/{projectId}/devices

Request

  • Base URL
    https://api.golioth.io
  • URL
    https://api.golioth.io/v1/projects/{projectId}/devices
  • Auth
    API key in header x-api-key and API key in header Authorization

Path parameters

projectIdstring required

Project ID

Request body

blueprintIdstring
cohortIdstring
hardwareIdsstring[]
namestring
tagIdsstring[]

Response

A successful response.

Changes

  • dbbf7fd3a346Revision changes
    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

  • 1e1e047dcb23Revision changes
    • warning

      removed the request property

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property // to the response with the status