Ask for a fresh set of build questions at the next full review.
POST
/docs/{docId}/questions/fresh
const url = 'https://example.com/api/v1/docs/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/questions/fresh';const options = {method: 'POST'};
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://example.com/api/v1/docs/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/questions/freshA 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.
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”docId
required
string format: uuid
The ID of one spec doc.
Responses
Section titled “ Responses ”The questions are retired. The next full review writes a new set.
default
Section titled “default”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"}