Qualified search
Continue qualified search
Authorise a new credit budget on a qualified search, or retry a failed wave.
POST
Continue qualified search
First time? Set up Authentication
Learn how to authenticate your API requests with your API key.
GET /v1/search/talents/qualified/{castingId} returned nextAction continue or retry.
A continue is a new call: it authorises a new quota, target (target.greens and a credit cap target.maxCredits), and Kalent then analyses waves on its own until this call finds that many greens, the cap of this call, or the end of the talent pool. You do not call continue for each wave, only to authorise more spending. See the qualified search overview for calls, waves, and credits.
- If
nextActioniscontinue, Kalent opens a new call that looks fortarget.greensnew greens. Greens already returned do not count toward this call. The response is 202. - If
nextActionisretry, Kalent retries the failed wave with the remaining budget of the same call, capped by your balance. The call index does not change and no new budget is opened. If that call had already found itstarget.greens, nothing is retried: the call is closed and the response is 200 withstatuscan_continue; the next continue opens a new call. - If
nextActioniswait(statusrunning), the request returnscasting_run_in_progress. - If
nextActionisdone(statuspool_exhausted), the request returnscasting_pool_exhausted.
status is running. Poll GET while nextAction is wait, or wait for the end-of-call webhook.
Two API credits are charged for each talent that receives a verdict in the new call. Talents already billed on a failed wave are not charged again when that wave is retried.
The X-Api-Credits-Remaining header is your workspace balance right after the request, that is after Kalent reserved min(balance, target.maxCredits) for the new call (or the remaining budget of the retried call). Unused reserved credits come back when each wave ends. GET does not send this header.
Path
string
required
The
castingId of the qualified search.Request body
The body is optional. An empty body is valid: it reuses the storedtarget, webhook, and customParams. The scoring language is fixed at start and cannot be sent here: a body with scoringLanguage returns validation_error.
object
Quota of this call. Each field is independent: a field you omit keeps its stored value, so
{ "target": { "greens": 20 } } changes the green quota and leaves the credit cap as it was. Omitting target keeps both. On a retry the values are stored for the next call, but the retry itself keeps the quota and the remaining budget of the failed call.object
Omitted: the
webhook stored on the search is reused. Provided: url replaces the stored URL for this call and the following ones; verdicts replaces the stored verdicts only when sent, otherwise they are kept. Payload and headers are documented on POST /v1/search/talents/qualified.object
Optional JSON object with string keys, echoed on webhook payloads. Replaces the stored object when provided. The JSON serialization must be at most 4096 bytes.
Response
boolean
Whether the request completed without errors.
object
Present when
success is true.object
Present when
success is false.
