> ## 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.

# remove_candidate_from_sourcing

> Remove a candidate from a sourcing flow (sets status to NOT_RETAINED).

Removes a candidate from a sourcing flow by setting its status to `NOT_RETAINED`. The candidate row is kept; it is excluded from the active pipeline and any active outreach tasks are cancelled.

## Input

| Parameter     | Type   | Required | Description             |
| ------------- | ------ | -------- | ----------------------- |
| `candidateId` | string | Yes      | Candidate id to remove. |

## Output

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

## Errors

`session not found` or `Not found` when the candidate does not belong to the workspace.