Skip to content

Suggest a question

POST
/v1/question-suggestions
curl --request POST \
--url https://beta-api.plune.ai/v1/question-suggestions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "text": "Which smoke cases are still drafts?", "filter": "state=draft&tag=smoke" }'

A text of up to 500 characters and, if you have one, a filter - a filter string or a link of the case list. The same text (case, spaces and closing punctuation aside) already suggested, open or accepted, adds to the asks of that suggestion instead: 200 with repeated: true and the suggestion as it is (an accepted one with its questionId). A new text, or one whose earlier suggestion was declined, is a new suggestion: 201. A text of punctuation only, or one longer than 500 characters once normalized, is 400; so is a filter longer than 2000 characters once written out. Owner or member; a reader gets 403.

Media type application/json
object
text
required
string
>= 1 characters <= 500 characters
filter
string
<= 2000 characters
Example
{
"text": "Which smoke cases are still drafts?",
"filter": "state=draft&tag=smoke"
}

Asked again: one more ask of the open or accepted suggestion

Media type application/json
object
suggestion
required
object
id
required
string
projectId
required
string
text
required
string
>= 1 characters <= 500 characters
filter
required
string
nullable
state
required
string
Allowed values: new accepted declined
asks
required

How many times the same text (case, spaces and closing punctuation aside) was asked while it was open or accepted.

integer
>= 1
author
required
object
id
required
string
name
required
string
nullable
email
required
string
askers
required

Everyone who asked it, each once, the first author first; a gone account is left out. Private, as author.

Array<object>

A person a suggestion names - private, the page marks it so.

object
id
required
string
name
required
string
nullable
email
required
string
askerCount
required

How many people asked it (asks counts the asks: one person may ask twice).

integer
questionId
required

The question it became, once accepted.

string
nullable
declineReason
required
string
nullable
decidedBy
required
object
id
required
string
name
required
string
nullable
email
required
string
decidedAt
required
string format: date-time
nullable
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
repeated
required
boolean
Example
{
"suggestion": {
"state": "new"
}
}

Suggested

Media type application/json
object
suggestion
required
object
id
required
string
projectId
required
string
text
required
string
>= 1 characters <= 500 characters
filter
required
string
nullable
state
required
string
Allowed values: new accepted declined
asks
required

How many times the same text (case, spaces and closing punctuation aside) was asked while it was open or accepted.

integer
>= 1
author
required
object
id
required
string
name
required
string
nullable
email
required
string
askers
required

Everyone who asked it, each once, the first author first; a gone account is left out. Private, as author.

Array<object>

A person a suggestion names - private, the page marks it so.

object
id
required
string
name
required
string
nullable
email
required
string
askerCount
required

How many people asked it (asks counts the asks: one person may ask twice).

integer
questionId
required

The question it became, once accepted.

string
nullable
declineReason
required
string
nullable
decidedBy
required
object
id
required
string
name
required
string
nullable
email
required
string
decidedAt
required
string format: date-time
nullable
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
repeated
required
boolean
Example
{
"suggestion": {
"id": "6f1c2b3a-0000-4000-8000-0000000012a3",
"projectId": "u-shop::default",
"text": "Which smoke cases are still drafts?",
"filter": "tag=smoke&state=draft",
"state": "new",
"asks": 1,
"author": {
"id": "u-shop",
"name": "Olena",
"email": "olena@shop.example.com"
},
"askers": [
{
"id": "u-shop",
"name": "Olena",
"email": "olena@shop.example.com"
}
],
"askerCount": 1,
"questionId": null,
"declineReason": null,
"decidedBy": null,
"decidedAt": null,
"createdAt": "2026-09-16T09:12:04.151Z",
"updatedAt": "2026-09-16T09:12:04.151Z"
},
"repeated": false
}

Invalid body or filter

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No / invalid token or session

A read-only member

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over