Lower hand

To lower the hand of a live participant through the API, you need to execute a POST request against the /rooms/:id/participants/:participantId/lower-hand endpoint. After executing the call, then the raised hand will be removed from the Participants panel inside the room.

Request

cURL

curl --request POST \
  --header "Content-Type: application/json" \
  --url https://api.digitalsamba.com/api/v1/rooms/45d125d8-bac9-43a5-a6a8-311a5433239d/participants/53858671-c5e0-441a-9e33-e5d7f7f1861e/lower-hand \
  --user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY \

Java

import com.fasterxml.jackson.databind.ObjectMapper;

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.util.Base64;
import java.util.Map;

String TEAM_ID = "YOUR_TEAM_ID";
String DEVELOPER_KEY = "YOUR_DEVELOPER_KEY";
String authorizationHeader = "Bearer " + Base64.getEncoder().encodeToString((TEAM_ID + ":" + DEVELOPER_KEY).getBytes());
//Put your room id or friendly_url (name) here - this value is just an example
String roomId = "c39d7c40-7ff7-4faa-b06f-698a639a9523";
//Put your participant id here - this value is just an example
String participantId = "53858671-c5e0-441a-9e33-e5d7f7f1861e";

HttpRequest request = HttpRequest.newBuilder()
  .POST(HttpRequest.BodyPublishers.noBody()))
  .uri(new URI("https://api.digitalsamba.com/api/v1/rooms/" + roomId + "/participants/" + participantId + "/lower-hand"))
  .header("Authorization", authorizationHeader)
  .header("Content-Type", "application/json")
  .build();

HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request, BodyHandlers.ofString());

System.out.println("Status code: " + response.statusCode());
System.out.println("Body: " + response.body());

Response (200 OK) - empty