---
title: "PUT /v2/sensors/{serial_number}/"
method: PUT
path: "/v2/sensors/{serial_number}/"
tags: ["Sensors"]
---

# PUT /v2/sensors/{serial_number}/

`PUT /v2/sensors/{serial_number}/`

View a single sensor from an organization

## Request body

- SensorDetail
  - `serial_number` string, required
  - `uuid` string, nullable
  - `organization_id` integer, required
  - `doorway_id` integer
  - `doorway_name` string
  - `sensor_type` string, required
  - `device_function` string
  - `kind` string
  - `hardware_model` string
  - `is_virtual` string
  - `is_simulated` string
  - `status` 'unconfigured' | 'online' | 'error' | 'low_power' | 'archived'
  - `last_heartbeat` string, date-time
  - `current_disposition` string
  - `network_addresses` string
  - `firmware_version` string
  - `latest_config_change` string
  - `operating_system` string
  - `plan_sensor_id` string
  - `plan_sensor_plan_id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `space_ids` string
  - `use_legacy_status` boolean — Use Legacy Status: Enable this if the sensor should use the legacy status mechanism via heartbeats/check-ins.

## Response `200`

Updated

- OptionalSensorDetailSerializer
  - `serial_number` string, required
  - `uuid` string, nullable
  - `organization_id` integer, required
  - `doorway_id` integer
  - `doorway_name` string
  - `sensor_type` string, required
  - `device_function` string
  - `kind` string
  - `hardware_model` string
  - `is_virtual` string
  - `is_simulated` string
  - `status` 'unconfigured' | 'online' | 'error' | 'low_power' | 'archived'
  - `last_heartbeat` string, date-time
  - `current_disposition` string
  - `network_addresses` string
  - `firmware_version` string
  - `latest_config_change` string
  - `operating_system` string
  - `plan_sensor_id` string
  - `plan_sensor_plan_id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `space_ids` string
  - `use_legacy_status` boolean — Use Legacy Status: Enable this if the sensor should use the legacy status mechanism via heartbeats/check-ins.

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.dev/density/apis/your-project-api.md) · [All operations](https://skmtc.dev/density/apis/your-project-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/density/your-project-api/revisions/eab10fe035e6/schema)