---
updatedAt: 2026-09-23T20:14:13.000Z
agentTools:
  projectIndex: https://mediroutes-api.readme.io/llms.txt
---

# Add a new reroute or cancel reason

Add a new reroute or cancel reason.  The reason type must be either "Reroute" or "Cancel."

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "V1",
    "title": "MediroutesAPI V1"
  },
  "paths": {
    "/api/v{version}/brokerage/addRerouteOrCancelReason": {
      "post": {
        "tags": [
          "Brokerage"
        ],
        "summary": "Add a new reroute or cancel reason",
        "description": "Add a new reroute or cancel reason.  The reason type must be either \"Reroute\" or \"Cancel.\"",
        "operationId": "post-addrerouteorcancelreason",
        "parameters": [
          {
            "name": "version",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "access token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RerouteAndCancelAddModel"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/RerouteAndCancelAddModel"
              }
            },
            "application/xml": {
              "schema": {
                "$ref": "#/components/schemas/RerouteAndCancelAddModel"
              }
            },
            "text/xml": {
              "schema": {
                "$ref": "#/components/schemas/RerouteAndCancelAddModel"
              }
            },
            "application/x-www-form-urlencoded": {
              "schema": {
                "$ref": "#/components/schemas/RerouteAndCancelAddModel"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Reason Added",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RerouteAndCancelRequestModel"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/RerouteAndCancelRequestModel"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/RerouteAndCancelRequestModel"
                }
              },
              "text/xml": {
                "schema": {
                  "$ref": "#/components/schemas/RerouteAndCancelRequestModel"
                }
              }
            }
          },
          "400": {
            "description": "Missing or unaligned data. Error message will be returned with response."
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.mediroutes.com"
    }
  ],
  "components": {
    "schemas": {
      "RerouteAndCancelRequestModel": {
        "required": [
          "reason_type",
          "reason",
          "inactive"
        ],
        "type": "object",
        "properties": {
          "reason_type": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "inactive": {
            "type": "boolean"
          }
        }
      },
      "RerouteAndCancelAddModel": {
        "required": [
          "reason_type",
          "reason"
        ],
        "type": "object",
        "properties": {
          "reason_type": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```