Update TURN Credential Label
This endpoint is used to update the label for the TURN Credential.
POST
https://<appname>.metered.live/api/v2/turn/credential/update_label
<appname>
- replace it the name of your app.
Request
POST /api/v1/turn/credential
Query Parameters
Parameter | Description | Data Type |
---|---|---|
secretKey | The secret key for app identification | String |
username | The username of the credential for which you want to update the label | String |
Request Body
The request body should be a JSON object with the following fields:
Field | Description | Data Type |
---|---|---|
label | New Label for the Credential | String |
Responses
Success Response
A JSON object containing the updated TURN credential information:
Field | Description | Data Type |
---|---|---|
username | The username of the credential | String |
password | The password of the credential | String |
expiryInSeconds | The time in seconds for the credential to expire | Integer |
label | The label for the credential | String |
apiKey | The apiKey of the credential | String |
HTTP Status: 200 OK
Body:
{
"username": "<username>",
"password": "<password>",
"expiryInSeconds": 3600,
"label": "<label>",
"apiKey": "<apiKey>"
}
Error Responses
HTTP Status: 400 Bad Request
Body:
{
"message": "credential of the specified username not found"
}
Code Examples
JavaScript (Fetch API)
fetch("https://<appname>.metered.live/api/v2/turn/credential/update_label?username=<USERNAME>&secretKey=<YOUR_SECRET_KEY>", {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
"label": "exampleLabel"
}),
})