Messages

Toggle a vote on a poll option

Add or remove your line's vote on one poll option (per-option toggle — iMessage polls are toggled one option at a time). Returns the poll reflecting the toggle.

post/v3/messages/{messageId}/poll/votes

Request

  • Base URL: https://api.linqapp.com/api/partner
  • URL: https://api.linqapp.com/api/partner/v3/messages/{messageId}/poll/votes
  • Auth: HTTP bearer

Path parameters

messageIdstring uuid required
Example:69a37c7d-af4f-4b5e-af42-e28e98ce873a

The poll-definition message's ID

Request body

option_idstring uuid required

The option to toggle a vote on.

operation'add' | 'remove' required

Add or remove your line's vote on the option.

Response

Vote toggle accepted

chat_idstring uuid required
message_idstring uuid required

The poll-definition message's ID — reference this poll by it.

created_atstring date-time required
updated_atstring date-time required

Example response

{
  "chat_id": "550e8400-e29b-41d4-a716-446655440000",
  "message_id": "69a37c7d-af4f-4b5e-af42-e28e98ce873a",
  "reactions": [
    {
      "is_me": false,
      "handle": {
        "id": "69a37c7d-af4f-4b5e-af42-e28e98ce873a",
        "display_name": "Alice",
        "handle": "+15551234567"
      },
      "type": "love",
      "custom_emoji": null,
      "sticker": null
    }
  ],
  "poll": {
    "options": [
      {
        "text": "Tacos",
        "creator_handle": {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "handle": "+15551234567",
          "service": "iMessage",
          "joined_at": "2025-05-21T15:30:00.000-05:00",
          "line_type": "iMessage"
        },
        "voters": [
          {
            "handle": "+14155559876"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.