Create

To create a predefined poll you need to execute a POST request against the /rooms/:id/polls endpoint.

Predefined polls are loaded on session start.

You need to specify the poll question and also an array of the poll options. With the multiple param you can control if is a multiple choice question or not.

A poll can be configured to be anonymous - that means nobody in the room will be able to see who voted for what exact option. Only the total amount of votes will be seen, but not the concrete users.

Request

curl --request POST \
  --header "Content-Type: application/json" \
  --url https://api.digitalsamba.com/api/v1/rooms/c39d7c40-7ff7-4faa-b06f-698a639a9523/polls \
  --user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY \
  --data '{"question": "How many languages do you speak?", "multiple": false, "anonymous": false, "options": [{"text": "One"}, {"text": "Two"},{"text": "Three"}, {"text": "More than three"}]}'

Response (200 OK)

{
    "id": "c15102d9-ed47-468c-8e5a-86be0c97c296",
    "question": "How many languages do you speak?",
    "anonymous": false,
    "multiple": false,
    "status": "created",
    "options": [
        {"id":"f7524f3d-41f9-46bc-9dbf-918d5fd39618", "text":"One"},
        {"id":"1a4879dc-3a93-4e3d-8cae-5e1e6ed878f9", "text":"Two"},
        {"id":"f8877655-4470-4b26-9834-cd5016da79c3", "text":"Three"},
        {"id":"9b7c51c8-bc62-46db-8b7e-e28ed5d4d336", "text":"More than three"}
    ],
    "created_at":"2024-06-27T06:49:45Z"
}

Last updated