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

# 🛑 Cancelar tarea

Permite **cancelar una tarea** que ya fue iniciada.

Una vez cancelada:

* El estado de la tarea cambia a <Badge color="purple">Cancelada</Badge>.
* Ya **no se podrá firmar ni validar**.
* No se envían nuevas notificaciones ni recordatorios.

<Danger>
  Esta acción no es reversible
</Danger>

<Warning>
  * La tarea debe estar en estado EN\_PROGRESO.
  * No puede estar ya cancelada, vencida o finalizada.
</Warning>

***

## <Badge color="yellow" size="lg">POST</Badge> ➜ /v2/tareas/tarea\_id/cancel

`https://api.contractia.app/v2/tareas/tarea_id/cancel`

<Info>
  Reemplazar `{tarea_id}` por el ID numérico de la tarea deseada.
</Info>

<Warning>
  Es obligatorio poner un motivo de Cancelación el el request JSON.
</Warning>

¿Cómo obtener el ID de la tarea? [➜](/platform/buscar)

### 💻 Ejemplo de implementación

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl --location --request POST 'https://api.contractia.app/v2/tareas/{{tarea_id}}/cancel' \
    --header 'Authorization: Bearer {{api_key}}' \
    --header 'user_id: {{user_id}}' \
    --header 'Content-Type: application/json' \
    --data '{
        "cancelation_motive": "Motivo de cancelación de la tarea"
    }'
    ```
  </Tab>

  <Tab title="Request JSON">
    ```json theme={null}
    {
      "cancelation_motive": "Motivo de cancelación de la tarea"
    }
    ```
  </Tab>

  <Tab title="Response JSON">
    ```json theme={null}
    dfasdfafdsasdsadsdasd
    ```
  </Tab>
</Tabs>