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

# Administrar motivos de descarte

> Crea, renombra y elimina motivos y submotivos de tareas seleccionadas explícitamente.

Usa `change_discard_reasons` mediante MCP o envía esta solicitud directamente. Primero consulta cada tarea seleccionada con `get_discard_reasons`.

| Acción | Campos |
| - | - |
| `create_reason` | `label`, `definition` opcional |
| `rename_reason` | `code`, `label` |
| `delete_reason` | `code` |
| `create_subreason` | `reason_code`, `label` |
| `rename_subreason` | `reason_code`, `subreason_code`, `label` |
| `delete_subreason` | `reason_code`, `subreason_code` |
| `set_reason_definition` | `reason_code`, `definition` (vacía para borrar) |
| `set_requires_subreason` | `reason_code`, booleano `required` |

El primer motivo crea la lista si no existe. Un motivo puede empezar sin submotivos. Si exige un submotivo, la lista final debe contener al menos uno: reemplaza el último o desactiva el requisito en la misma solicitud. Eliminar el último motivo deja una lista vacía.

Renombrar conserva los códigos. Recrear un nombre eliminado genera un código nuevo. Eliminar un motivo quita también sus submotivos de las opciones disponibles; los descartes históricos conservan sus valores registrados. Los nombres duplicados se rechazan dentro de la misma lista. El mismo nombre de submotivo puede existir bajo motivos diferentes.

Usa `set_reason_definition` en el lote para cambiar descripciones de varias tareas de forma atómica. `set_discard_reason_definitions` sigue disponible para una sola tarea; una cadena vacía borra la descripción. Los campos omitidos no cambian. Vuelve a consultar cada tarea después de guardar. Si se pierde la respuesta, consulta antes de reintentar. Los cambios en las tareas seleccionadas se guardan todos juntos o no se guarda ninguno.

Los códigos nuevos pueden necesitar opciones equivalentes en tu CRM externo. Configúralas por separado; guardar la lista en Nexor no verifica la sincronización con el CRM.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.