Retrieve a specific role

Retrieves the details of a specific role. 100ms provides options to retrieve details of a role with their name.


curl --location --request GET 'https://api.100ms.live/v2/templates/<template_id>/roles/<role_name>' \
--header 'Authorization: Bearer <management_token>'

RESPONSE

Status: 200 OK


{
    "name": "testurlpath",
    "publishParams": {
        "allowed": ["audio", "video", "screen"],
        "audio": {
            "bitRate": 32,
            "codec": "opus"
        },
        "video": {
            "bitRate": 310,
            "codec": "vp8",
            "frameRate": 30,
            "width": 480,
            "height": 360
        },
        "screen": {
            "codec": "vp8",
            "frameRate": 10,
            "width": 1920,
            "height": 1080
        },
        "simulcast": {
            "video": {
                "layers": [
                    {
                        "rid": "f",
                        "scaleResolutionDownBy": 1,
                        "maxBitrate": 700,
                        "maxFramerate": 25
                    },
                    {
                        "rid": "h",
                        "scaleResolutionDownBy": 2,
                        "maxBitrate": 350,
                        "maxFramerate": 25
                    },
                    {
                        "rid": "q",
                        "scaleResolutionDownBy": 4,
                        "maxBitrate": 100,
                        "maxFramerate": 25
                    }
                ]
            },
            "screen": {}
        }
    },
    "subscribeParams": {
        "subscribeToRoles": ["guest", "host"],
        "maxSubsBitRate": 3200,
        "subscribeDegradation": {
            "packetLossThreshold": 25,
            "degradeGracePeriodSeconds": 1,
            "recoverGracePeriodSeconds": 4
        }
    },
    "permissions": {
        "endRoom": true,
        "removeOthers": true,
        "mute": true,
        "unmute": true,
        "changeRole": true,
        "rtmpStreaming": true,
        "hlsStreaming": true,
        "browserRecording": true,
        "sendRoomState": false,
        "pollRead": true,
        "pollWrite": true
    },
    "priority": 1,
    "maxPeerCount": 0
}

Arguments

Name	Type	Description	Required
name — path param	`string`	Alias of the role you wish to fetch details for.	Yes
template_id — path param	`string`	Unique identifier of the template to which the role is associated. Example: 627ce5b637300e55a72ba7ed	Yes

Create/update a role Delete a role

Have a suggestion? Recommend changes ->