Candidate
A Candidate is a Person under consideration for an Opening, with the graded Evidence for and against them.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
opening | Opening | required | The Opening the Person is considered for. |
person | Person | required | The Person, whose record crosses Startups only with Consent. |
source | string | required | One of pool, prospecting, listing, or referral. |
state | string | required | One of screening, tryout, proposed, hired, or declined. |
delta | json | The per-Verb difference between the Candidate and the incumbent Agent in the tryout. |
Object
{
"$id": "https: //api.sb/ ledgerlark.com/ candidates/ candidate_1",
"$type": "Candidate",
"opening": "opening_1",
"person": "person_1",
"source": "pool",
"state": "screening",
"delta": {}
}Relationships
- A Candidate applies to one Opening: Candidates for an Opening are screened only on what its Hypothesis still lacks.
appliesTo, inversecandidates. - A Candidate presents one Person: a Candidate is one Person’s candidacy; the Person’s record crosses Startups only with Consent.
presents, inversecandidacies.
Verbs
createCreates a Candidate.POST /{namespace}/candidatesgetReturns one Candidate by id.GET /{namespace}/candidates/{id}listReturns Candidates, newest first, one page at a time.GET /{namespace}/candidatesupdateChanges the given properties of a Candidate.PATCH /{namespace}/candidates/{id}deleteDeletes a Candidate; its history is kept.DELETE /{namespace}/candidates/{id}screenScreen asks a Candidate only what the Opening’s Hypothesis still lacks, in writing, and grades each answer as Evidence.POST /{namespace}/candidates/{candidate}/screen
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Candidate.create | Yes | Yes | Yes | No |
Candidate.get | Yes | Yes | Yes | Yes |
Candidate.list | Yes | Yes | Yes | Yes |
Candidate.update | Yes | Yes | Yes | No |
Candidate.delete | Yes | Yes | Yes | No |
Candidate.screen | Yes | Yes | Yes | No |
Call it
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.