Vote on an idea, or take the vote back

POST

/v1/board/widget/posts/{id}/vote

One vote per idea per voter: a signed-in user (user_id with user_hash), else client_id. vote: false takes it back. Only approved ideas can be voted on.

Auth: Publishable key from the browser (CORS *, no cookies, limited per IP address), or a secret key. A user_id must come with user_hash = HMAC-SHA256(notifications signing secret, user_id) as lowercase hex; a wrong or missing hash answers USER_HASH_INVALID (403), never an anonymous vote. The signed user’s id is stored only as a one-way hash.

Authorizations

• PublishableApiKey
• SecretApiKey

Parameters

Path Parameters

id

required

string

Request Body ^required

object

vote

boolean

default: true

client_id

string

user_id

string

user_hash

string

Responses

200

votes and voted

400

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties

401

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties

403

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties

404

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties

429

Error envelope. See error.code for the discriminator.

object

data

required

null

error

required

object

code

required

string

message

required

string

remediation

required

string

doc_url

string format: uri

param

string

request_id

string

meta

object

key

additional properties