Screening

Confirm a finding or mark it a false positive, with a reason

An organization owner or admin, signed in to the dashboard. API keys and members are refused (403).

post/api/v1/screening/adverse-media/findings/{id}/decision

Request

  • Base URL: https://api.korala.ai
  • URL: https://api.korala.ai/api/v1/screening/adverse-media/findings/{id}/decision
  • Auth: one of:
    • API key in header X-API-Key
    • bearer (a scheme the document does not define)

Path parameters

idstring required

Headers

X-Korala-Mode'live' | 'test'

Dashboard JWT: live (default) or test. API keys are pinned to their credential mode. Mode cannot be changed after creation.

Idempotency-Keystring required

Retry the same decision with the same key; a changed decision returns 409.

Request body

decision'confirmed' | 'false_positive' required

confirmed: the article is about this subject and adverse. false_positive: it is not (another person, or nothing adverse).

reasonstring required

Why, in words. Trimmed; blank or whitespace only is refused.

Response

idstring uuid required
status'clear' | 'possible_finding' | 'finding' | 'incomplete' | 'error' required

finding: an open finding about the subject, or a confirmed one. possible_finding: open findings whose subject is unclear. clear: nothing found by a complete run. incomplete: nothing found, but something was not searched or judged. error: nothing could be searched or judged.

incompleteboolean required

Something was not searched or judged. Never a clear result, whatever the status.

incompleteReasonsstring[] required
errorCode'missing_name' | 'name_too_long' | 'not_configured' | 'retrieval_failed' | 'judge_failed' | 'concurrency_limited' | 'invalid_config' | 'no_session' nullable required
trigger'check_step' | 'api' required
sandboxboolean required
simulatedboolean required

The fake provider and judge answered: nothing was sent to a search API or a model. Every test-mode run is simulated.

sessionIdstring uuid nullable required
participantIdstring uuid nullable required
riskSubjectIdstring uuid nullable required
workflowRunIdstring uuid nullable required
riskFactstring required

screening.adverse_media

riskSourcestring required

The risk source its evidence is recorded under: korala:screening:adverse_media:v1.

findingCountnumber required
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.