> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kalent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# update_candidate_status

> Change the status of a candidate in a sourcing.

Updates the status of a candidate in the authenticated workspace.

## Input

| Parameter      | Type   | Required | Description                                                                                                                                       |
| -------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `candidateId`  | string | Yes      | Candidate id to update.                                                                                                                           |
| `statusHandle` | string | Yes      | Target status handle. A global status (`TO_BE_CONTACTED`, `CONTACTED`, `NOT_RETAINED`, `OUTREACH_SEQUENCE_STARTED`) or a custom workspace status. |

## Output

JSON block with `success: true` and `data` containing `candidateId`, `talentId`, `sourcingId`, `statusHandle`, and `updatedAt`.

## Errors

`session not found`, `Not found`, or `Validation error` when the status handle is unknown.