Skip to content

Accept a suggestion

POST
/v1/question-suggestions/{id}/accept
curl --request POST \
--url https://beta-api.plune.ai/v1/question-suggestions/example/accept \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "title": "Smoke cases still in draft" }'

Makes a question of the library from it - the given filter, or the suggestion own (400 filter_required with neither) - and links them. Decided once: 409 suggestion_decided. At most 100 active questions (409 question_limit). Owner or member; a reader gets 403.

id
required
string
Media type application/json
object
title
required
string
>= 1 characters <= 120 characters
filter
string
<= 2000 characters
Example
{
"title": "Smoke cases still in draft"
}

Accepted, with the question it became

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
question
required
object
id
required
string
projectId
required
string
title
required
string
>= 1 characters <= 120 characters
config
required

A question (#1292): a canonical case-filter query string - the one of GET /v1/test-cases and of a plan - and, for the questions a health widget answers, its name.

object
schemaVersion
required
integer
Allowed values: 1
kind
required
string
Allowed values: question
filter
required

The cases the question asks about: n, and the link.

string
<= 2000 characters
base

The cases N counts; absent, every live case of the project.

string
<= 2000 characters
source

The handler that answers it, as the Analytics card does.

string
Allowed values: never_run ever_failing flaky slowest last_run_cost
starterKey

A starter question key; the page words its title in the reader language by it.

string
position
required
integer
createdBy
required

null for a starter question: nobody made it.

string
nullable
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
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": "accepted",
"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": "6f1c2b3a-0000-4000-8000-000000001292",
"declineReason": null,
"decidedBy": null,
"decidedAt": null,
"createdAt": "2026-09-16T09:12:04.151Z",
"updatedAt": "2026-09-16T09:12:04.151Z"
},
"question": {
"id": "6f1c2b3a-0000-4000-8000-000000001292",
"projectId": "u-shop::default",
"title": "Smoke cases still in draft",
"config": {
"schemaVersion": 1,
"kind": "question",
"filter": "tag=smoke&state=draft"
},
"position": 12,
"createdBy": "u-shop",
"createdAt": "2026-09-16T09:12:04.151Z",
"updatedAt": "2026-09-16T09:12:04.151Z"
}
}

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"
}

No such suggestion in the project

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

Already decided, or no room for the question

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