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

# Manage discard reasons

> Create, rename and delete reasons and subreasons for explicitly selected tasks.

Use `change_discard_reasons` through MCP, or send this request directly. Read the selected task with `get_discard_reasons` first.

| Action | Fields |
| - | - |
| `create_reason` | `label`, optional `definition` |
| `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` (empty clears) |
| `set_requires_subreason` | `reason_code`, boolean `required` |

The first reason creates a missing list. A reason can start with no subreasons. A required subreason must exist in the final saved list; replace the last one or disable the requirement in the same request. Deleting the last reason leaves an empty list.

Renaming preserves codes. Recreating a deleted name gets a new code. Deleting a reason also removes its subreasons from the available choices; historical discards keep their recorded values. Duplicate names are rejected within the same list. The same subreason label may appear under different parents.

Use `set_reason_definition` in the batch for atomic description changes across tasks. `set_discard_reason_definitions` remains available for one task; an empty string clears a description. Omitted properties stay unchanged. Read every selected task again after saving. If a response is lost, read before retrying. Changes across the selected tasks either all succeed or none is saved.

New codes may need matching options in your external CRM. Configure those options separately; saving the Nexor list does not verify CRM synchronization.


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