API Error Code Reference

The Smart Device Management API uses standard gRPC error codes. For more information on those codes, see error handling.

An error response in the API appears in the following format:

{
  "error": {
    "code": 404,
    "message": "Device enterprises/project-id/devices/device-id not found.",
    "status": "NOT_FOUND"
  }
}

Use the search box in the Error Codes table to find Device Access errors, along with troubleshooting tips and related traits and guides. You can search for content in any field in the table.

Error Message HTTP RPC Troubleshooting
Camera image is no longer available for download. 504 DEADLINE_EXCEEDED Event images expire 30 seconds after the event is published. Make sure to download the image prior to expiration.

See also:
  Download a camera image task
  Display device
  Doorbell device
  Events guide
  GenerateImage command
  CameraMotion trait
  CameraPerson trait
  CameraSound trait
  DoorbellChime trait
Command not allowed in current thermostat mode. 400 FAILED_PRECONDITION Certain commands are not applicable in certain thermostat modes.

See also:
  Change the temperature setpoints task
  ThermostatEco trait
  ThermostatMode trait
  ThermostatTemperatureSetpoint trait
Command not allowed when thermostat in MANUAL_ECO mode. 400 FAILED_PRECONDITION The temperature setpoint cannot be set when the thermostat is in manual Eco mode.

See also:
  Change the temperature setpoints task
  ThermostatEco trait
  ThermostatTemperatureSetpoint trait
Command not provided. 404 NOT_FOUND A command was executed without a valid command name in the request body. Enter a valid command.
Contains an invalid value. 400 INVALID_ARGUMENT A command was submitted with an invalid value in the arguments. Make sure to send a valid value.
Cool value must be greater than heat value. 400 INVALID_ARGUMENT Make sure that the heatCelsius field is less than the coolCelsius field in your command.

See also:
  Change the temperature setpoints task
  ThermostatTemperatureSetpoint trait
Device not found. 404 NOT_FOUND An invalid or missing device name was specified. Specify a valid device.

See also:
  Connectivity trait
Enterprise not found. 404 NOT_FOUND An invalid or missing Project ID was specified. Specify a valid Project ID.
Event id does not belong to the camera. 400 FAILED_PRECONDITION Use the correct eventID returned by the camera event.

See also:
  Handle camera events task
  Display device
  Handle doorbell and camera events task
  Events guide
  CameraEventImage trait
  CameraMotion trait
  CameraPerson trait
  CameraSound trait
  DoorbellChime trait
Field is not present in traits. 400 INVALID_ARGUMENT An unsupported command was sent for a trait.
Rate limited. 429 RESOURCE_EXHAUSTED Each developer has a quota limiting how many calls they can make. If you make more calls than your quota, you will receive the Rate limited message. To fix this, resubmit the call once the quota has expired.

See also:
  Sandbox rate limits concept
Room not found. 404 NOT_FOUND The room does not exist in the structure. Make a list call to the rooms resource to verify the Room ID.
Structure not found. 404 NOT_FOUND The structure does not exist in the enterprise. Make a list call to the structure resource to verify the structure ID.
Thermostat fan unavailable. 400 FAILED_PRECONDITION The thermostat does not have a fan capability. Fan-related traits and commands cannot be used for this device.

See also:
  Turn the fan on or off task
  Fan trait