Tuya

Tuya Smart is a global leading AI cloud platform service provider (NYSE: TUYA; HKEX: 2391) that enables IoT device manufacturers, solution providers, and app developers to build smart home and industrial IoT applications. The platform provides APIs for device management, smart home management, scene automation, data analytics, and industry-specific integrations across smart home, energy, security, and industrial verticals. Tuya operates six global data centers and handles over 100 million concurrent requests.

Tuya publishes 1 API on the APIs.io network: Device Management API. Tagged areas include IoT, Smart Home, Devices, Cloud Platform, and Automation.

The Tuya catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Tuya’s developer surface includes authentication, documentation, signup flow, getting-started guide, developer portal, and 17 more developer resources.

🌐 Visit website 📡 Source on GitHub

49.8/100 developing ▬ flat Agent 64/100 agent native Full breakdown ↓
scored 2026-07-20 · rubric v0.4

4 APIs 1 Agent Skills 0 Features

IoTSmart HomeDevicesCloud PlatformAutomationIndustrial IoTDevice Management

API Rating

API Evangelist Rating How this is scored →
scored 2026-07-20 · rubric v0.4

Composite quality — 49.8/100 · developing

Contract Quality 11.8 / 25

Developer Ergonomics 9.6 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 3.4 / 13

Governance 10.4 / 12

Discoverability 6.8 / 10

Agent readiness — 64/100 · agent native

Machine-Readable Contract 18 / 18

Agentic Access Contract 15 / 15

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/tuya: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

Get Started 3

Portal, sign-up, and the first successful call

Signup

Signup

GettingStarted

GettingStarted

Portal

Portal

Documentation 4

Reference material describing how the API behaves

Documentation

OpenAPI

JSONSchema

JSONSchema

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

MCPServer

AgentSkills

LlmsText

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

JSONLD

JSONLD

SpectralRules

SpectralRules

Vocabulary

Vocabulary

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

Access & Security 3

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Authentication

Authentication

Commercial 1

Pricing, plans, and the legal terms of use

TermsOfService

TermsOfService

Company 2

The organization behind the API

LinkedIn

Website

Website

Other 1

Properties that don't map to a standard resource type

API Explorer

API Explorer

Source (apis.yml)

opencollection: 1.0.0
info:
  name: Tuya Device Management API
  version: '1.0'
request:
  auth:
    type: apikey
    key: client_id
    value: '{{client_id}}'
    placement: header
items:
- info:
    name: Devices
    type: folder
  items:
  - info:
      name: Get Device Details
      type: http
    http:
      method: GET
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
    docs: Retrieve detailed information about a specific device including its attributes, status, online state, and product
      information.
  - info:
      name: Update Device Name
      type: http
    http:
      method: PUT
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
      body:
        type: json
        data: '{}'
    docs: Modify the friendly name of a specified device.
  - info:
      name: Remove Device
      type: http
    http:
      method: DELETE
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
    docs: Remove a device from the cloud account and deregister it.
  - info:
      name: List Devices
      type: http
    http:
      method: GET
      url: https://openapi.tuyaus.com/v1.0/devices
      params:
      - name: device_ids
        value: ''
        type: query
        description: Comma-separated list of device IDs to query
      - name: schema
        value: ''
        type: query
        description: Include device schema information
      - name: last_row_key
        value: ''
        type: query
        description: Pagination cursor key
      - name: page_size
        value: ''
        type: query
        description: Number of results per page (max 100)
    docs: Query devices associated with a cloud project by application, product, or a set of device IDs.
  - info:
      name: List User Devices
      type: http
    http:
      method: GET
      url: https://openapi.tuyaus.com/v1.0/users/:uid/devices
      params:
      - name: uid
        value: ''
        type: path
        description: Unique user identifier
      - name: last_row_key
        value: ''
        type: query
        description: Pagination cursor key
      - name: page_size
        value: ''
        type: query
        description: Number of results per page
    docs: Retrieve all devices associated with a specific user account.
  - info:
      name: Get Device Factory Information
      type: http
    http:
      method: GET
      url: https://openapi.tuyaus.com/v1.0/devices/factory-infos
      params:
      - name: device_ids
        value: ''
        type: query
        description: Comma-separated list of device IDs
    docs: Retrieve manufacturing and factory information for one or more devices.
- info:
    name: Device Control
    type: folder
  items:
  - info:
      name: Send Device Commands
      type: http
    http:
      method: POST
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id/commands
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
      body:
        type: json
        data: '{}'
    docs: Send one or more control commands to a device. Commands correspond to device data points (DPs) defined in the product
      schema.
  - info:
      name: Get Device Status
      type: http
    http:
      method: GET
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id/status
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
    docs: Retrieve the current status of all data points for a device.
  - info:
      name: Reset Device to Factory Settings
      type: http
    http:
      method: PUT
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id/reset-factory
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
    docs: Restore a device to its factory default settings and unpair it from the current account.
- info:
    name: Device Logs
    type: folder
  items:
  - info:
      name: Get Device Operation Logs
      type: http
    http:
      method: GET
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id/logs
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
      - name: type
        value: ''
        type: query
        description: Log type (1=device, 7=tap-to-run automation)
      - name: start_row_key
        value: ''
        type: query
        description: Pagination cursor
      - name: start_time
        value: ''
        type: query
        description: Start timestamp in milliseconds
      - name: end_time
        value: ''
        type: query
        description: End timestamp in milliseconds
      - name: size
        value: ''
        type: query
        description: Number of records to return (max 50)
      - name: codes
        value: ''
        type: query
        description: Comma-separated list of data point codes to filter by
    docs: Query the operation logs of a specified device filtered by event type, code, and time range.
- info:
    name: Sub Devices
    type: folder
  items:
  - info:
      name: List Sub Devices
      type: http
    http:
      method: GET
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id/sub-devices
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
    docs: Retrieve a list of sub-devices connected through a gateway device.
- info:
    name: Device Users
    type: folder
  items:
  - info:
      name: Add Device User
      type: http
    http:
      method: POST
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id/users
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
      body:
        type: json
        data: '{}'
    docs: Associate a user with a device to grant access permissions.
  - info:
      name: Get Device User
      type: http
    http:
      method: GET
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id/users/:user_id
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
      - name: user_id
        value: ''
        type: path
        description: User ID
    docs: Retrieve information about a user associated with a device.
  - info:
      name: Update Device User
      type: http
    http:
      method: PUT
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id/users/:user_id
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
      - name: user_id
        value: ''
        type: path
        description: User ID
      body:
        type: json
        data: '{}'
    docs: Modify a user's role or permissions for a device.
  - info:
      name: Remove Device User
      type: http
    http:
      method: DELETE
      url: https://openapi.tuyaus.com/v1.0/devices/:device_id/users/:user_id
      params:
      - name: device_id
        value: ''
        type: path
        description: Unique device identifier
      - name: user_id
        value: ''
        type: path
        description: User ID
    docs: Remove a user's association with a device.
bundled: true

Tuya

API Rating

APIs

Tuya Device Management API

Tuya Smart Home API

Tuya Authorization API

Tuya Industry API

Agent Skills

tuya-smart-control

Collections

Tuya Device Management API

Pricing Plans

Tuya Plans Pricing

Rate Limits

Tuya Rate Limits

FinOps

Tuya Finops

Semantic Vocabularies

Tuya Context

API Governance Rules

Tuya API Rules

Tuya API Rules

JSON Structure

Tuya Device Structure

Example Payloads

Tuya Get Device Example

Tuya Send Device Commands Example

Resources