Skip to main content
POST
Continue qualified search

First time? Set up Authentication

Learn how to authenticate your API requests with your API key.
Continue a qualified search after 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 nextAction is continue, Kalent opens a new call that looks for target.greens new greens. Greens already returned do not count toward this call. The response is 202.
  • If nextAction is retry, 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 its target.greens, nothing is retried: the call is closed and the response is 200 with status can_continue; the next continue opens a new call.
  • If nextAction is wait (status running), the request returns casting_run_in_progress.
  • If nextAction is done (status pool_exhausted), the request returns casting_pool_exhausted.
When a call is accepted the response is 202 and 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 stored target, 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.

Example