Skip to content

Ask for a fresh set of build questions at the next full review.

POST
/docs/{docId}/questions/fresh
curl --request POST \
--url https://example.com/api/v1/docs/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/questions/fresh

A doc keeps its build questions from one version to the next. This retires every one of them, so the next full review writes a new set. It is the only way the whole set changes. It calls no model. Only a person who can edit the doc may do it.

docId
required
string format: uuid

The ID of one spec doc.

The questions are retired. The next full review writes a new set.

An error.

Media typeapplication/problem+json

RFC 9457 problem details with a stable code.

object
type
required
string
title
required
string
status
required
integer
detail
string
instance
string
code
required

A stable machine-readable error code.

string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example",
"code": "example"
}