The Raise Hand handler allows the raise or lower the hand of an ongoing call. The request must be done using POST. The response is the same as in the /calls request, returning the modified connections.

Raises or lowers the hand and returns the currently running calls of the selected channel.

{
    "raise":            "<True, if the hand should be raised>",
    "clients": [
        {
            "clientId": "<GUID of the client that should be modified>",
            "media":    "<The media type of the connection that should be modified.>"
        },
        ...
    ]
}

Note: the clients field is optional. Optional fields can be omitted and will not change the current state.

# Request
# Use user:password for authorization
POST /api/cowork/teams/3n1ytbwme7ngfyn9g9guwwurt/channels/3y8kdto0lnx3ig3mshwvrb9x7/calls/raise HTTP/1.1
Accept: */*
Authorization: Bearer VGhpcyBpcyBqdXN0IGEgZGVtbyBhY2Nlc3MgdG9rZW4u
 
{
    "raise": true
}
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
[
    {
        "userId": "51hsegfzptqm6z3q8c6qkad7a",
        "displayName": "Jane Doe",
        "clientId": "cowork-390e29ba-fe73-4dd0-affc-b78ea328769b",
        "media": "camera",
        "muted": false,
        "silent": false,
        "video": false,
        "handUp": true
    }
]