Smart Device Management API

Name: Smart Device Management API API
Brand: Smart Device Management API
Availability: InStock

✓ Official Vendor SpecIOTHome Automationoauth25 EndpointsREST

For Agents

Read traits and execute commands on a user's Nest thermostats, cameras, and doorbells. List devices under an enterprise and inspect their parent structures and rooms.

Quickstart

Get started with Smart Device Management API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"control a Nest thermostat"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Smart Device Management API API.

List every Nest device a user has authorised under a Device Access enterprise

Retrieve a single device's current traits — thermostat mode, setpoint, humidity, online status

Execute a typed command against a device, such as setting the thermostat to heat at 21°C

List the structures (homes) the user has shared with the integration

GET STARTED

Start building with Smart Device Management API API

Explore with Jentic

View OpenAPI Document

The Smart Device Management API gives developers and AI agents programmatic access to a Google account holder's Nest devices and the structures and rooms they belong to. It exposes operations to list devices under a user enterprise, retrieve a device's current traits (such as thermostat setpoints, camera images, and doorbell events), and execute commands like setting a target temperature mode. Authorisation is obtained through Device Access partner enrolment plus a per-user OAuth consent flow, after which devices appear under the authorising user's enterprise.

Use Cases

Patterns agents use Smart Device Management API API for, with concrete tasks.

★ Voice Assistant Thermostat Control

Wire a custom voice assistant to adjust a user's Nest thermostat by name. The assistant lists structures and rooms to map 'the bedroom' to a device resource, then executes the SetHeat command with the requested temperature. The Smart Device Management API returns the updated trait state so the assistant can confirm the change spoken-back to the user.

List devices under enterprises/abc123, find the device with displayName 'Bedroom Thermostat', then execute sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat with heatCelsius=20.

Home Status Dashboard

Build an at-a-glance dashboard that shows the current temperature, mode, and online status of every Nest thermostat and camera in a household. The integration polls the devices.list endpoint and surfaces traits like ThermostatTemperatureSetpoint and Connectivity, refreshing every few minutes. Useful for property managers monitoring multiple homes.

List all devices under the enterprise, then for each thermostat retrieve traits and render mode, ambientTemperatureCelsius, and Connectivity.status.

Energy-Saving Automation

Run a scheduled automation that lowers the heating setpoint when the user is away. The agent reads the current thermostat trait to decide whether action is needed, then issues a SetHeat command via the executeCommand endpoint. Because each command response confirms the new trait state, the automation can verify the change took effect before logging.

Get device enterprises/abc/devices/xyz, then call executeCommand with sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat heatCelsius=16.

AI Agent Smart Home Control

An AI agent receives a natural-language instruction like 'turn the heating down by 2 degrees in the living room' and resolves it into a Smart Device Management command. Through Jentic, the agent discovers the executeCommand operation, loads the command schema, then issues the call with the resolved device resource and temperature delta.

Search Jentic for 'set a Nest thermostat temperature', load executeCommand, then execute with the resolved device resource and the SetHeat command body.

Key Endpoints

5 endpoints — the smart device management api gives developers and ai agents programmatic access to a google account holder's nest devices and the structures and rooms they belong to.

METHOD

PATH

DESCRIPTION

GET

/v1/{+parent}/devices

List Nest devices under an enterprise

GET

/v1/{+name}

Retrieve a device, structure, or room by resource name

POST

/v1/{+name}:executeCommand

Execute a typed command against a device

GET

/v1/{+parent}/structures

List structures (homes) shared with the integration

GET

/v1/{+parent}/rooms

List rooms within a structure

GET

/v1/{+parent}/devices

List Nest devices under an enterprise

GET

/v1/{+name}

Retrieve a device, structure, or room by resource name

POST

/v1/{+name}:executeCommand

Execute a typed command against a device

GET

/v1/{+parent}/structures

List structures (homes) shared with the integration

GET

/v1/{+parent}/rooms

List rooms within a structure

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Device Access partner OAuth credentials and per-user refresh tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped, short-lived access tokens on each call — partner secrets and user refresh tokens never enter the agent context.

Intent-based discovery

Agents search Jentic with intents like 'set a Nest thermostat temperature' or 'list smart devices in a home', and Jentic returns the matching enterprises.devices.list or executeCommand operation with its request schema.

Time to first call

Direct Smart Device Management integration: 3-5 days for Device Access partner enrolment, OAuth flow, command schema handling, and Pub/Sub event wiring. Through Jentic: under 1 hour for the API surface itself once partner enrolment is complete.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

HomeGraph API

HomeGraph reports device state to Google Assistant; Smart Device Management lets you read and control devices directly.

Choose HomeGraph when you are publishing a smart-home action that responds to Google Assistant requests. Choose Smart Device Management when you need direct read/write access to Nest devices on behalf of a user.

Complementary

Cloud Pub/Sub API

Device events from Smart Device Management are delivered through a Pub/Sub topic the partner subscribes to.

Use Cloud Pub/Sub to receive doorbell, motion, and trait-change events from authorised Nest devices in near real time.

Complementary

Google IAM API

IAM controls service account permissions on the Google Cloud project that hosts the Device Access integration.

Use IAM when configuring or auditing the service identities that operate the Device Access integration's backend infrastructure.

FAQs

Specific to using Smart Device Management API API through Jentic.

What authentication does the Smart Device Management API use?

The Smart Device Management API uses OAuth 2.0 layered on top of Google's Device Access program — developers must enrol as a Device Access partner before any user OAuth consent is possible. Through Jentic, the partner OAuth tokens are stored in the Jentic vault (MAXsystem) and exchanged for short-lived access tokens on each call.

Can I control a user's Nest thermostat with the Smart Device Management API?

Yes. POST /v1/{+name}:executeCommand accepts typed commands such as sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat or SetCool, which adjust the heating or cooling setpoint on a thermostat device that the user has authorised.

What are the rate limits for the Smart Device Management API?

Google's Device Access program enforces a low quota by design — a few queries per minute per device for trait reads and commands — to protect end-user devices. Agents should cache trait values locally and only execute commands in response to user intent rather than polling aggressively.

How do I send a thermostat command through Jentic?

Search Jentic for 'set a Nest thermostat temperature', load the executeCommand schema, and execute against the device resource POST /v1/{+name}:executeCommand with a command body identifying SetHeat or SetCool and the target temperature in Celsius.

Is the Smart Device Management API free?

The API itself has no per-call charge, but Google's Device Access program requires a one-time partner registration fee per developer to obtain a Project ID for production use. Sandbox testing on a single account is supported during development.

Which Nest devices does the Smart Device Management API support?

The API exposes Nest thermostats, Nest cameras, and Nest doorbells through device traits like ThermostatTemperatureSetpoint, ThermostatMode, CameraImage, and DoorbellChime. Older Works-with-Nest integrations are not supported — only devices visible to the modern Device Access program.