Skip to main content
Returns the latest dynamic sequence status for a candidate in the authenticated workspace sourcing. Use this tool after start_dynamic_sequences to poll progress by candidateId.

Input

Output

JSON block with success: true and data: candidateId, talentId, sourcingId, and sequence (or null). When displayStatus is ACTION_REQUIRED, the response also includes requiresAction: true and actionRequired details.
displayStatus: "TALENT_REPLIED" only describes the dynamic sequence: it is set when a reply interrupts a running dynamic sequence, so it does not cover legacy sequences nor replies received once the sequence is no longer running. To know whether a talent replied at all, regardless of sequence type or timing, use replyStatus returned by get_candidate and get_candidates.

Errors

session not found, Not found, or a human-readable error when the candidate cannot be resolved.