Set a verdict

POST

api

scans

{id}

candidates

{candidateId}

verdict

curl --request POST \
  --url https://api.revcenter.ai/api/scans/{id}/candidates/{candidateId}/verdict \
  --header 'Content-Type: application/json' \
  --cookie session= \
  --data '
{
  "verdict": "reject",
  "reasonCodes": [
    "wrong_seniority",
    "geo_mismatch"
  ],
  "notes": "Director-level, and based in Ottawa."
}
'

{
  "ok": true,
  "verdict": "accept"
}

{
  "error": "criteria (CriteriaV2) is required"
}

{
  "error": "Sign in required"
}

{
  "error": "Scan not found"
}

{
  "error": "Spec extraction failed"
}

Authorizations

session

string

required

A signed-in workspace session, sent as a browser cookie. Requests must include credentials, and act on the session's active workspace.

Path Parameters

string<uuid>

required

The search ID.

candidateId

string

required

The candidate's ID, as returned in candidates[].candidate.id.

Body

application/json

verdict

enum<string> | null

null clears the verdict and logs a verdict_cleared event.

Available options:

accept,

reject,

maybe,

null

reasonCodes

string[]

Why. reason_codes is accepted as an alias.

notes

string

Free-text note. Truncated at 4000 characters.

Maximum string length: 4000

source

string

default:scan_candidate_panel

Where the verdict came from, for attribution in the feedback log.

Maximum string length: 120

Response

The verdict was recorded.

boolean

verdict

enum<string> | null

Available options:

accept,

reject,

maybe,

null

curl --request POST \
  --url https://api.revcenter.ai/api/scans/{id}/candidates/{candidateId}/verdict \
  --header 'Content-Type: application/json' \
  --cookie session= \
  --data '
{
  "verdict": "reject",
  "reasonCodes": [
    "wrong_seniority",
    "geo_mismatch"
  ],
  "notes": "Director-level, and based in Ottawa."
}
'

{
  "ok": true,
  "verdict": "accept"
}

{
  "error": "criteria (CriteriaV2) is required"
}

{
  "error": "Sign in required"
}

{
  "error": "Scan not found"
}

{
  "error": "Spec extraction failed"
}

Get Started

Search

People

Companies

Campaigns

Authorizations

Path Parameters

Body

Response