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.

actioneffect
expandSweep the node's upstream even if the evidence gate would not. The sweep comes out of the traversal's existing budget.
pruneNever sweep the node.
recordKeep 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 candidate id from โ€ฆ/results, provisional or final.
  • action (string, required) โ€” expand, prune or record.
  • relation (string, optional) โ€” supplies, manages, own_site, same_group or co_listed.
  • reason (string, optional, max 1000) โ€” the reviewer's reason.

Response

  • 201 โ€” the stored discovery_decision. by is the acting user, or org:<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