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 current user.

{
    "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/user/calls/raise HTTP/1.1
Accept: */*
Authorization: Bearer VGhpcyBpcyBqdXN0IGEgZGVtbyBhY2Nlc3MgdG9rZW4u
 
{
    "raise": true
}
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
[
    {
        "teamId": "z1hc4tcuiitho9g37x3rbcjj2",
        "channelId": "x67aca5q3kvwyhebed0tey5ab",
        "states": [
            {
                "userId": "51hsegfzptqm6z3q8c6qkad7a",
                "displayName": "Jane Doe",
                "clientId": "cowork-390e29ba-fe73-4dd0-affc-b78ea328769b",
                "media": "camera",
                "muted": true,
                "silent": false,
                "video": false,
                "handUp": false
            }
        ]
    }
]