Record Discovery Decision
Record a reviewer's decision on one candidate of a running discovery task. A running traversal reads the decisions before it enqueues child sweeps.
| action | effect |
|---|---|
expand | Sweep the node's upstream even if the evidence gate would not. The sweep comes out of the traversal's existing budget. |
prune | Never sweep the node. |
record | Keep the decision on file. The search does not change. |
A decision never ingests anything. Provisional candidates are review-only;
โฆ/ingest reads the finished result only.
โถRequest
โถMethod & Path
POST /discovery/source/{taskId}/decisions
โถPath parameters
taskId(UUID, required) โ the discovery task id.
โถBody
candidate_id(string, required) โ the candidateidfromโฆ/results, provisional or final.action(string, required) โexpand,pruneorrecord.relation(string, optional) โsupplies,manages,own_site,same_grouporco_listed.reason(string, optional, max 1000) โ the reviewer's reason.
โถResponse
- 201 โ the stored
discovery_decision.byis the acting user, ororg:<id>for a key with no user. - 400 โ invalid body or a non-UUID
taskId. - 401 / 403 โ missing or invalid key, or the key lacks
discovery:write. - 404 โ the task is unknown or belongs to a different organization.
- 409 โ the task has finished; no search is left to apply the decision.
- 422 โ the discovery service rejected the decision (for example an unknown candidate).
- 502 โ transient upstream failure.
Required scope:
discovery:write