Sub Account Setting

This is the list of settings where the value of ‘JSON Name’ must be sent in the requests

JSON Name	Display Name
cameraModule	Camera Module
noiseCancelling	Noise Cancelling
transcription	Transcription
playerAutoPlay	Player Auto Play
logo	Logo
audioMuted	Audio Muted
fullscreen	Fullscreen
downloadable	Downloadable
dealerName	Dealer Name
dealerUrl	Dealer Url

Overview

The SubAccountSettingsController provides endpoints for managing sub account settings. It supports creating, retrieving, updating, and deleting sub account settings associated with an sub account.

Base URL

/api/subaccount/settings

Authorization

Access to these endpoints requires following authority:

• ADMIN

Endpoints

1. Get All SubAccount Settings

Method: GET

URL: /api/subaccount/settings

Authorization: Required

Description: Fetches all sub account settings for the authenticated sub account.

Example cURL Request:

curl --location --request GET 'https://sdk-mobile-api-rc.truvideo.com/api/subaccount/settings' \
--header 'Authorization: Bearer {{YOUR-ACCESS-TOKEN}}'

Response:

Returns a JSON object containing a list of sub account settings.

{
    "settings": [
        {
            "key": "cameraModule",
            "value": false
        },
        {
            "key": "downloadable",
            "value": true
        },
        {
            "key": "fullscreen",
            "value": true
        },
        {
            "key": "noiseCancelling",
            "value": true
        },
        {
            "key": "transcription",
            "value": true
        },
        {
            "key": "dealerName",
            "value": "The Dealer"
        },
        {
            "key": "dealerUrl",
            "value": "https://www.thedealer.com"
        }
    ]
}

2. Get Sub Account Setting by Key

Method: GET

URL: /api/subaccount/settings/key/{KEY}

Authorization: Required

Description: Retrieves a specific sub account setting by its key.

Example cURL Request:

curl --location --request GET 'https://sdk-mobile-api-rc.truvideo.com/api/subaccount/settings/key/{{KEY}}' \
--header 'Authorization: Bearer {{YOUR-ACCESS-TOKEN}}'

Response:

Returns the sub account setting if found.

{
    "key": "noiseCancelling",
    "value": true
}

3. Create Sub Account Setting

Method: POST

URL: /api/subaccount/settings

Authorization: Required

Request Body:

The request body should include a JSON object conforming to the CreateSubsAccountSettingDTO structure.

{
    "key": {{KEY}},
    "value": {{VALUE}}
}

Example cURL Request:

curl --location --request POST 'https://sdk-mobile-api.truvideo.com/api/subaccount/settings' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{YOUR-ACCESS-TOKEN}}' \
--data '{
    "key": {{KEY}},
    "value": {{VALUE}}
}'

Response:

Returns the created sub account setting.

{
    "key": "downloadable",
    "value": false
}

1. Update Sub Account Setting

Method: PUT

URL: /api/subaccount/settings

Authorization: Required

Request Body:

The request body should include a JSON object conforming to the UpdateSubAccountSettingDTO structure.

{
    "key": {{KEY}},
    "value": {{VALUE}}
}

Example cURL Request:

curl --location --request PUT 'https://sdk-mobile-api-rc.truvideo.com/api/subaccount/settings' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{YOUR-ACCESS-TOKEN}}' \
--data '{
    "key": {{KEY}},
    "value": {{VALUE}}
}'

Response :

Returns the updated sub account setting.

{
    "key": "transcription",
    "value": true
}

Params:

BASE-URL:

• Release Candidate (RC): https://sdk-mobile-api-rc.truvideo.com

• Production: https://sdk-mobile-api.truvideo.com

---

YOUR-ACCESS-TOKEN:

Access token provided by the endpoint mentioned on this documentation: [SDK Mobile] - Generate an API Token

---

KEY:

The key must be one of this json names:

• cameraModule

• noiseCancelling

• transcription

• playerAutoPlay

• logo

• audioMuted

• fullscreen

• downloadable

• dealerName

• dealerUrl

---

VALUE:

The values for each key are:

• cameraModule: Boolean

• noiseCancelling: Boolean

• transcription: Boolean

• playerAutoPlay: Boolean

• logo: String

• audioMuted: Boolean

• fullscreen: Boolean

• downloadable: Boolean

• dealerName: String

• dealerUrl: String

Status Code	Description
204	No Content. The logo was sucessfully removed

Settings Inheritance Between Accounts and SubAccounts

When creating an Account, not all settings are automatically inherited by its SubAccounts.

Currently, only the following settings are inherited from the parent Account to its SubAccounts:

JSON Name	Display Name
cameraModule	Camera Module
noiseCancelling	Noise Cancelling
transcription	Transcription
playerAutoPlay	Player Auto Play
audioMuted	Audio Muted
fullscreen	Fullscreen
downloadable	Downloadable

Any other settings configured at the Account level will not be inherited and must be explicitly set on each SubAccount if required.