Suggest an idea from the widget

POST

/v1/board/widget/posts

Waits for the owner’s approval before anyone sees it. email is optional and shown only to the owner. Limited per address per hour, and at most 200 suggestions wait at once. website must be left empty: it is the form’s trap for bots, and a request with anything in it is answered 201 and dropped.

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

Request Body ^required

object

title

required

string

>= 3 characters <= 120 characters

body

string

<= 2000 characters

email

string format: email

website

Leave empty.

string

user_id

string

user_hash

string

client_id

string

Responses

201

id and status: pending

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