PUT Polls

Reset Poll

CANNOT BE UNDONE.

PUT /api/v3/{appid}/poll/poll/{pollid}/reset

CANNOT BE UNDONE. This deletes all responses for a poll. The purpose of this method is so you can test a poll before opening it to the public.

URL Arguments

pollid : (required) The ID of the poll to reset.

Request

Parameters

Values in the path and query string.

appid path

string TalkLabs ID required

The TalkLabs application ID assigned to your account.

Example: your-app-id

pollid path

string TalkLabs ID required

The TalkLabs assigned poll ID.

Example: poll-id

Response

Status codes

Every JSON response uses the API result envelope.

200 OK ApiResult

400 Bad Request ApiResult

403 Forbidden ApiResult

500 Internal Server Error ApiResult

Example response · 200

{
  "message": "The specified conversation and all comments were permanently deleted.",
  "errors": {},
  "data": {
    "kind": "delete.conversation",
    "conversationid": "api-conversation-demo1",
    "userid": null,
    "deletedconversations": 1,
    "deletedcomments": 17
  }
}

curl --request PUT \
  --url "https://api.sportstalk247.com/api/v3/${APP_ID}/poll/poll/${POLL_ID}/reset" \
  --header "Accept: application/json" \
  --header "x-api-token: ${TALKLABS_API_TOKEN}"

const appId = process.env.TALKLABS_APP_ID;
const pollid = 'poll-id';

const response = await fetch(
  `https://api.sportstalk247.com/api/v3/${appId}/poll/poll/${pollid}/reset`,
{
  method: 'PUT',
  headers: {
    Accept: 'application/json',
    'x-api-token': process.env.TALKLABS_API_TOKEN,
  },
});

const result = await response.json();

import json
import os
import requests

app_id = os.environ["TALKLABS_APP_ID"]
pollid = "poll-id"

response = requests.put(
    f"https://api.sportstalk247.com/api/v3/{app_id}/poll/poll/{pollid}/reset",
    headers={
        "Accept": "application/json",
        "x-api-token": os.environ["TALKLABS_API_TOKEN"],
    },
)
response.raise_for_status()
result = response.json()

Environment variables TALKLABS_APP_ID TALKLABS_API_TOKEN

Response