Create Poll | Taktoria API

curl -X POST https://api.taktoria.com/api/v1/dory/events/eventId/polls \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "type": "MULTIPLE_CHOICE",
  "question": "question"
}'

{
  "id": "id",
  "eventId": "eventId",
  "type": "MULTIPLE_CHOICE",
  "question": "question",
  "status": "DRAFT",
  "allowMultiple": true,
  "isAnonymous": true,
  "ratingMax": 1,
  "sortOrder": 1,
  "options": [
    {
      "id": "id",
      "label": "label",
      "sortOrder": 1,
      "isCorrect": true
    },
    {
      "id": "id",
      "label": "label",
      "sortOrder": 1,
      "isCorrect": true
    }
  ],
  "createdAt": "2024-01-15T09:30:00Z",
  "updatedAt": "2024-01-15T09:30:00Z",
  "timeLimitSec": 1,
  "responseCount": 1,
  "launchedAt": "2024-01-15T09:30:00Z",
  "closedAt": "2024-01-15T09:30:00Z"
}

Add a poll, at the end of the event’s list unless sortOrder says where. See CreatePollRequest for the limits. Opening a poll closes the live one: created with status: LIVE, it closes whichever poll was live in the event.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

eventIdstringRequired

Request

This endpoint expects an object.

typeenumRequired

questionstringRequired

statusenumOptional

DRAFT unless given.

Allowed values:

allowMultiplebooleanOptional

isAnonymousbooleanOptional

ratingMaxintegerOptional

RATING polls' points on the scale, 2 to 10. Default 5.

timeLimitSecintegerOptional

5 to 600 seconds.

sortOrderintegerOptional

Its place in the event's list. Left out, after the last.

optionslist of objectsOptional

Response

This endpoint returns an object.

idstring

eventIdstring

typeenum

questionstring

statusenum

Allowed values:

allowMultipleboolean

isAnonymousboolean

ratingMaxinteger

sortOrderinteger

optionslist of objects

createdAtdatetime

updatedAtdatetime

timeLimitSecintegerOptional

responseCountintegerOptional

launchedAtdatetimeOptional

When it last went live. Every opening is stamped anew, since a quiz times its answers from it.

closedAtdatetimeOptional

When it was closed; cleared when it goes live again or back to DRAFT.

Errors

403

Forbidden Error

404

Not Found Error

422

Validation Error

429

Too Many Requests Error