Suggest a question
const url = 'https://beta-api.plune.ai/v1/question-suggestions';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"text":"Which smoke cases are still drafts?","filter":"state=draft&tag=smoke"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
Example
{ "text": "Which smoke cases are still drafts?", "filter": "state=draft&tag=smoke"}Responses
Section titled “ Responses ”Asked again: one more ask of the open or accepted suggestion
object
object
How many times the same text (case, spaces and closing punctuation aside) was asked while it was open or accepted.
object
Everyone who asked it, each once, the first author first; a gone account is left out. Private, as author.
A person a suggestion names - private, the page marks it so.
object
How many people asked it (asks counts the asks: one person may ask twice).
The question it became, once accepted.
object
Example
{ "suggestion": { "state": "new" }}Suggested
object
object
How many times the same text (case, spaces and closing punctuation aside) was asked while it was open or accepted.
object
Everyone who asked it, each once, the first author first; a gone account is left out. Private, as author.
A person a suggestion names - private, the page marks it so.
object
How many people asked it (asks counts the asks: one person may ask twice).
The question it became, once accepted.
object
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
object
Example generated
{ "error": "example"}No / invalid token or session
A read-only member
object
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.
object
Example generated
{ "error": "example"}Headers
Section titled “Headers ”Seconds until the window rolls over