Skip to content

Decline a suggestion

POST
/v1/question-suggestions/{id}/decline
curl --request POST \
--url https://beta-api.plune.ai/v1/question-suggestions/example/decline \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "reason": "Analytics already shows it as Failures by message" }'

With the reason its author reads (AC-18), 1 to 500 characters. Decided once: 409 suggestion_decided. Owner or member; a reader gets 403.

id
required
string
Media type application/json
object
reason
required
string
>= 1 characters <= 500 characters
Example
{
"reason": "Analytics already shows it as Failures by message"
}

Declined

Media type application/json
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
Example
{
"id": "6f1c2b3a-0000-4000-8000-0000000012a3",
"projectId": "u-shop::default",
"text": "Which smoke cases are still drafts?",
"filter": "tag=smoke&state=draft",
"state": "declined",
"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": "Analytics already shows it as Failures by message",
"decidedBy": null,
"decidedAt": null,
"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