Skip to main content
POST
Answer one round of proposed refinements

Authorizations

Authorization
string
header
required

Enforced on every transport, with no exempt operation. A person's request — over the default local unix socket exactly as over a TCP listener — must carry a JWT issued by the configured identity provider, which the host verifies itself against that issuer's key set: signature, issuer, expiry, and the person and organisation it names. Requests without a valid one receive 401 NRY-0011. The socket's file permissions are transport and are not an authorisation.

Path Parameters

roundId
string<uuid>
required

The refinement round's id, as proposeRefinement returned it or as refinement-proposed announced it.

Body

application/json

What a person decided about one round. Three verbs and four answers on the screen: accepting the round, accepting the marked items, rejecting the round, and rejecting it with a message — the last two write exactly the same rows (none) and differ only in what the next review reads.

roundAnswer
enum<string>
required
Available options:
accept-round,
accept-marked,
reject-round
marks
object[]

One entry per item a person marked, naming it by the index the round sent. Refused alongside accept-round, which means all of it and carries no marks on purpose: a client saying "all of it" must not have to enumerate the round back.

message
string

What the person typed. It is not decoration: the next review reads it as a correction, which is what stops the same rejected fact being proposed again tomorrow night.

Maximum string length: 4000

Response

Answered, with what the answer left behind: the rows written, and every accepted mark this host would not write, by name.

What one answered round left behind.

written
object[]
required

One row per accepted mark that survived, in the round's own order.

refused
object[]
required
appliedToSessionId
string<uuid>

The ONE conversation that takes this round on its next turn — the one the round was taught in, which has already paid for the prompt prefix this changes. Every other session, including another window of the same person's, takes the facts from its next start. Absent when nothing was written.