---
name: "agreeOpenDoor"
mode: "api"
versionRequirements:
  - { name: "@ray-js/lock-sdk", version: "1.0.0" }
title: "agreeOpenDoor - Approve a remote unlock request, applicable to WiFi Pro category devices."
summary: "Approve a remote unlock request, applicable to WiFi Pro category devices. Call this interface to confirm unlocking when a visitor requests to unlock via doorbell."
---

## agreeOpenDoor

> [VERSION] @ray-js/lock-sdk >= 1.0.0

### Description

Approve remote door-open request (used by Wi‑Fi Pro solution)

### Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `timeout` | `number` | No | Timeout (ms) |

### Return Value

Type: `Promise<void>`

None (resolves when done)

### Error Codes

| Error Code | Error Message |
| --- | --- |
| `1052` | Previous operation on the same device is still in progress |
| `1002` | Operation timed out |
| `1003` | Remote unlock failed (cloud invocation error) |
| `1004` | Device reported unlock failure |
| `1005` | Remote unlock failed (key invalidated) |
| `1006` | Key usage limit reached |
| `1007` | Key not within validity period |
| `1008` | Invalid key |

### Examples

#### Example

```ts
import { agreeOpenDoor } from '@ray-js/lock-sdk';
await agreeOpenDoor();
```