Create sensor

POST /networks/{network_identifier}/sensors
Bearer token

Creates a new sensor with the given name in the given network.

Path parameters

  • network_identifier string Required

    Format should match the following pattern: ^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$.

application/json

Body

  • sensor_name string Required

    The regex means: lowercase letters and numbers, separated by dashes, with no leading, trailing, or double dashes.

    Maximum length is 64. Format should match the following pattern: ^[a-z0-9](-?[a-z0-9])*$.

Responses

  • 201

    Created

    Hide response attribute Show response attribute object
    • sensor_identifier string

      Format should match the following pattern: ^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$.
  • 400

    Bad Request

  • 401

    Unauthorized

  • 403

    Forbidden

  • 404

    Not Found

  • 409

    Conflict

POST /networks/{network_identifier}/sensors 
curl \
 -X POST https://example.com/networks/575a7328-4e2e-4b88-afcc-e0b5ed3920cc/sensors \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"sensor_name":"happy-un1c0rn"}'
Request example 
{
  "sensor_name": "happy-un1c0rn"
}
Request examples 
{
  "sensor_name": "happy-un1c0rn"
}
Response examples (201) 
{
  "sensor_identifier": "575a7328-4e2e-4b88-afcc-e0b5ed3920cc"
}
Response examples (201) 
{
  "sensor_identifier": "575a7328-4e2e-4b88-afcc-e0b5ed3920cc"
}