# Retrieves the user confirmation prompt settings for remote control sessions

Returns the user confirmation prompt configuration for remote control, including whether prompting is enabled, prompt timeout duration, blank screen on connect, keyboard/mouse lock, permanent prompt, and idle session timeout settings.

## Endpoints

GET `/dcapi/tools/remoteControl/rdsPromptSettings`

## Request URL

`https://{server-hostname}:8383/dcapi/tools/remoteControl/rdsPromptSettings`

## Scope

`RemoteControl.READ`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

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

## Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/tools/remoteControl/rdsPromptSettings \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

#### Response Body — application/json

`JSON Object`

- **isPromptEnabled** `integer`: User confirmation prompt: 0=Disabled, 1=Enabled
- **promptTimeOut** `integer`: Prompt auto-dismiss timeout in seconds
- **promptMessage** `string`: Custom message displayed in the user confirmation dialog
- **isAlwaysPrompt** `integer`: Always show prompt: 0=No, 1=Yes
- **isPromptPermanent** `integer`: Permanent prompt mode: 0=Disabled, 1=Enabled

## Possible Response Codes

- **200** `HTTP code`

## Sample Response: HTTP 200

```json
{
  "promptTimeOut": 30,
  "isShowBlankScreen": 1,
  "isLockKeyboardMouse": 1,
  "idleTimeout": 30,
  "isAlwaysPrompt": 0,
  "promptMessage": "A technician is requesting remote access to your computer.",
  "isPromptPermanent": 0,
  "isPromptEnabled": 1
}
```

![ ](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.