booth_move.md

booth/move Endpoint

The booth/move endpoint enables you to move a user in the waitlist.

Note: You need to have sufficient permissions in the room to access this resource.

Endpoint

booth/move

Method

POST

Parameters

userID: ID of the user you want to move

position: The new position of the user

Note: The waitlist has a zero based index, so to move the user to the desired position you have to think about it as n-1 where n equals the desired position

{
    "userID": -1,
    "position": 0
}

Possible error messages

Insufficient permissions

{
    "data": [
        "You are not authorized to access this resource."
    ],
    "status": "notAuthorized",
}

User is not in the waitlist

{
    "data": [],
    "status": "userNotInBooth",
}

userID or position is missing

{
    "data": [
        "xxxxx is required"
    ],
    "status": "requestError",
}

Data returned

{
    'data': [],
    'meta': {},
    'status': 'ok',
    'time': 'xx.xxxxxxxxxxx'
}