Skip to content

Get Poll Configuration

GET /vote_config

Returns the stored configuration and computed poll status.

Authorization

Send Authorization: <Twitch Extension Client ID> <Muxy JWT>. The JWT role must satisfy the endpoint requirements shown in the examples.

Parameters

Name In Required Type Constraints Description
id query no string default "default"; at most 64 characters Poll identifier. Defaults to default; global polls use an ID beginning with global.

Responses

200 Response

Poll configuration.

Content type: application/json

Schema
{
  "type": "object",
  "properties": {
    "userIDVoting": {
      "type": "boolean"
    },
    "distinctOptionsPerUser": {
      "type": "integer",
      "minimum": 1,
      "maximum": 258,
      "default": 1
    },
    "totalVotesPerUser": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1024,
      "default": 1
    },
    "votesPerOption": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1024,
      "default": 1
    },
    "global": {
      "type": "boolean"
    },
    "disabled": {
      "type": "boolean"
    },
    "prompt": {
      "type": "string"
    },
    "options": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "userData": {},
    "endsAt": {
      "type": "integer",
      "description": "Unix timestamp in seconds."
    },
    "startsAt": {
      "type": "integer",
      "description": "Unix timestamp in seconds."
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "active",
        "expired"
      ],
      "readOnly": true
    }
  }
}

404 Error

No configuration exists for this poll.

Content type: application/json

Schema
{
  "type": "object"
}
Example
{}

Generated API reference

This endpoint is generated from rest-v1.yaml.