Skip to main content
POST
Vote on Message

Authorizations

Authorization
string
header
required

An App API key, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Headers

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-11-07"

Path Parameters

id
string
required

The ID of the message containing the poll.

Body

application/json
poll_option_id
string
required

The option ID from the poll, not its display text.

Example:

"2"

Response

updated poll-containing resource

attachments
object[]
required
author
object | null
required
author_is_team_member
boolean
required

true if the author is a team member of the account that owns this community channel. false for partners, private and support channels, and deleted messages.

Example:

false

author_user_id
string | null
required
Example:

"user_xxxxxxxxxxxxxx"

channel_id
string
required
Example:

"feed_xxxxxxxxxxxxxxxxxxxxxx"

content
string | null
required

Markdown content; null for a deleted message.

Example:

"Content 1"

created_at
string
required

Creation time as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

custom_author
object | null
required
deleted_at
string | null
required

Deletion time, or null for a live message.

Example:

null

edited
boolean
required
Example:

false

embeds
object[]
required
gifs
object[]
required
id
string
required

Existing public message ID, preserved across REST and chat clients.

Example:

"post_xxxxxxxxxxxxxxxxxxxxxx"

mentioned_user_ids
string[]
required
message_type
enum<string>
required
Available options:
regular,
system,
automated
Example:

"regular"

pinned
boolean
required
Example:

false

plain_content
string | null
required

Unformatted message text. null when the text is absent or the message is deleted

Example:

"Content 1"

poll
object | null
required
reaction_counts
object[]
required
replying_to_message_id
string | null
required
Example:

null

replying_to_user_id
string | null
required

User ID of the replied-to message's author, prefixed user_. null without a reply in this channel, or when either message is deleted.

Example:

null

updated_at
string
required

Last message change as an ISO 8601 timestamp.

Example:

"2026-01-01T12:00:00.000Z"

view_count
integer | null
required

Experience view count; null for DM-backed channels.

Example:

null