Skip to content

Candidate

A Candidate is a Person under consideration for an Opening, with the graded Evidence for and against them.

Properties

PropertyTypeRequiredDescription
openingOpeningrequiredThe Opening the Person is considered for.
personPersonrequiredThe Person, whose record crosses Startups only with Consent.
sourcestringrequiredOne of pool, prospecting, listing, or referral.
statestringrequiredOne of screening, tryout, proposed, hired, or declined.
deltajsonThe per-Verb difference between the Candidate and the incumbent Agent in the tryout.

Object

JSON
{
  "$id": "https://api.sb/ledgerlark.com/candidates/candidate_1",
  "$type": "Candidate",
  "opening": "opening_1",
  "person": "person_1",
  "source": "pool",
  "state": "screening",
  "delta": {}
}

Relationships

Verbs

  1. createCreates a Candidate.
    POST /{namespace}/candidatesdoCandidate.created
  2. getReturns one Candidate by id.
    GET /{namespace}/candidates/{id}readNo Event
  3. listReturns Candidates, newest first, one page at a time.
    GET /{namespace}/candidatesreadNo Event
  4. updateChanges the given properties of a Candidate.
    PATCH /{namespace}/candidates/{id}doCandidate.updated
  5. deleteDeletes a Candidate; its history is kept.
    DELETE /{namespace}/candidates/{id}doCandidate.deleted
  6. screenScreen asks a Candidate only what the Opening’s Hypothesis still lacks, in writing, and grades each answer as Evidence.
    POST /{namespace}/candidates/{candidate}/screendoCandidate.screened

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Candidate.createYesYesYesNo
Candidate.getYesYesYesYes
Candidate.listYesYesYesYes
Candidate.updateYesYesYesNo
Candidate.deleteYesYesYesNo
Candidate.screenYesYesYesNo

Call it

Text
Screen the candidate Rosa Ibarra.

Example

A Candidate for a cofounder Opening at a clinic-scheduling API arrives from the talent pool with shipped work from a past Startup. Her tryout closes three clinic-group deals the Sales Lead Agent had stalled on, so her state moves to proposed.