v58

latestOpenAPI 3.0.3agplraw.githubusercontent.com2026-08-01187461.6 MB
poll

Create a poll

post/ocs/v2.php/apps/spreed/api/{apiVersion}/poll/{token}

Path parameters

apiVersion'v1' required
tokenstring required

Headers

x-nextcloud-federationstring

Set to 1 when the request is performed by another Nextcloud Server to indicate a federation request

OCS-APIRequestboolean required

Required to be true for the API request to pass

Request body

questionstring required

Question of the poll

optionsstring[] required

Options of the poll

resultMode0 | 1 required

Mode how the results will be shown

maxVotesinteger required

Number of maximum votes per voter

draftboolean

Whether the poll should be saved as a draft (only allowed for moderators and with talk-polls-drafts capability)

threadIdinteger

Thread id which this poll should be posted into (also requires threads capability)

Response

Draft created successfully