*******************************************
``POST`` Cancel Candidate Deletion
*******************************************

This API cancels a previously scheduled candidate deletion by **revoking the deletion request** and restore the candidate's active status.

.. important::

    Revoking the scheduled deletion is only possible within 7 days of the scheduled deletion.

Request URL
=============

.. code-block::

    POST /candidate/deletion/cancel

Body Parameters
================

.. code-block:: JSON

    {
        "task_id": "string"
    }

.. warning::

    Make sure to add your API key in Header of the request.

Parameters
============

+-------------------+------------------+-----------------------------------------------------------------------------------------------------+
| Parameter         | Type             | Description                                                                                         |
+===================+==================+=====================================================================================================+
| task_id           | *string*         | The unique task ID returned when the candidate was scheduled for deletion.                          |
+-------------------+------------------+-----------------------------------------------------------------------------------------------------+

Response
==========

- A JSON response confirming whether the scheduled deletion was successfully canceled.

.. code-block:: JSON

    {
        "success": true,
        "message": "Candidate deletion canceled successfully"
    }

Error Responses
================

- If the task ID is invalid or no scheduled deletion is found:

.. code-block:: JSON

    {
        "success": false,
        "error": "Invalid task ID or no deletion found"
    }