***

id: 2185b17c-2f12-4645-bc02-c30a88162ca0
title: requestPermissions
slug: /js/reference/webrtc/request-permissions
description: requestPermissions function in the WebRTC namespace.
max-toc-depth: 3
----------------

### requestPermissions

* `Const` **requestPermissions**(`constraints`): `Promise<void>`

Prompts the user to grant permissions for the devices matching the specified set of constraints.

#### Parameters

<ParamField path="constraints" type="MediaStreamConstraints" required={true}>
  A [MediaStreamConstraints](https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamConstraints) object specifying requirements for the permissions.
</ParamField>

#### Returns

`Promise<void>`

#### Examples

To only request audio permissions:

```javascript
await SignalWire.WebRTC.requestPermissions({ audio: true, video: false });
```

To request permissions for both audio and video, specifying constraints for the video:

```javascript
const constraints = {
  audio: true,
  video: {
    width: { min: 1024, ideal: 1280, max: 1920 },
    height: { min: 576, ideal: 720, max: 1080 },
  },
};
await SignalWire.WebRTC.requestPermissions(constraints);
```