Polls

Create a poll (host action)

POST
/api/v1/polls

Authorization

tenant-api-key
x-api-key<token>

Tenant API key (backend only — never expose to a browser)

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/api/v1/polls" \  -H "Content-Type: application/json" \  -d '{    "question": "Which topic should we cover next?",    "options": [      "Recordings",      "Webinars",      "Breakouts"    ],    "roomId": "clxyz...",    "createdByExternalId": "user_abc123"  }'
{  "id": "string",  "roomId": "string",  "question": "string",  "status": "DRAFT",  "isAnonymous": true,  "allowMultiple": true,  "totalVotes": 0,  "options": [    {      "id": "string",      "text": "string",      "order": 0,      "count": 0    }  ],  "createdAt": "2019-08-24T14:15:22Z",  "closedAt": {}}