# Retrieves the screen recording configuration for remote control sessions

Returns the screen recording settings for remote control sessions, including whether recording is enabled, frame rate, codec type, storage size limits, color quality, and whether authenticated video download is required.

## Endpoints

`GET /dcapi/tools/remoteControl/screenRecording`

## Request

### Request URL

https://[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/tools/remoteControl/screenRecording

### Scope

`DesktopCentralCloud.RemoteControl.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** `string` — **Mandatory**
  - `application/json`

### Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/tools/remoteControl/screenRecording \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### Response Parameters

#### HTTP code 200

Response Body — `application/json`

`JSON Object`

- **isScreenRecEnabled** `integer`
  - Screen recording: 0=Disabled, 1=Enabled
- **framesPerSec** `integer`
  - Recording frame rate
- **codecType** `integer`
  - Video codec type identifier
- **colorQuality** `integer`
  - Color quality level
- **recMaintainsSize** `integer`
  - Maximum storage size in MB for recordings. Range: 1-1000
- **driveFreeSpace** `integer`
  - Minimum free space check: 0=Disabled, 1=Enabled
- **isAuthVideoDownload** `integer`
  - Authenticated video download: 0=Disabled, 1=Enabled
- **isNotifyUserEnabled** `integer`
  - Notify end user about recording: 0=Disabled, 1=Enabled
- **notifyMessage** `string`
  - Notification message shown to the end user during recording

### Possible Response Codes

- **200** `HTTP code`

### Sample Response: HTTP 200

```json
{
  "isNotifyUserEnabled": 1,
  "notifyMessage": "This session is being recorded.",
  "isScreenRecEnabled": 1,
  "framesPerSec": 15,
  "recMaintainsSize": 500,
  "codecType": 1,
  "driveFreeSpace": 1,
  "colorQuality": 2,
  "isAuthVideoDownload": 0
}
```

## Rate Limits

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.