Last Updated on : 2022-06-01 10:14:57

Send a command to bypass or resume a specified perimeter device. After receiving the command, the perimeter device will implement the bypass or resuming operation. Bypassing is a separate operation for one or several specific devices in the area. The bypassed devices in the area will not send an alarm. Resuming means that a device in the area changes from the bypassed status to the normal status.

API address

POST: /v1.0/intrusion/{device_id}/actions/by-pass

Request parameter

Parameter nameTypeINRequiredDescription
device_idStringuritrueThe ID of a Tuya device.

Description of body

Parameter nameTypeINRequiredDescription
by_passBoolean trueSpecifies whether to bypass or resume a specified device. Valid values:
  • true: bypass.
  • false: resume.

Return parameter

Parameter nameTypeDescription
resultCmdIssueResultResponseThe returned result.

Description of result

Parameter nameTypeDescription
snStringThe command record ID.

Request example

POST: /v1.0/intrusion/6ce****/actions/by-pass
  "byPass": false

Return example

    "result": {
        "sn": "133****"
    "t": 1561456817168,
    "success": true

Error code

For more information, see error code.