# Cancel a dispatch

**POST /ext/dispatch/{id}/status**

cancel an existing dispatch


## Servers
- https://dev.hubz.nyotek.com: https://dev.hubz.nyotek.com ()



## Parameters

### Path parameters
- **id** (string)
  ID of the dispatch to use


### Body: application/json (object)

- **status** (string)
  cancelled status input
- **ref_id** (string)
  unique identifier of the user cancelling a dispatch
- **ref_type** (string)



## Responses
### 204
successful operation

### 401
Unauthorized if incorrect api_key is given

#### Body: application/json (object)
- **error** (string)
  generic information about the error
- **error_desc** (string)
  error information for the developer

### 404
if the dispatch id is not found in the system

#### Body: application/json (object)
- **error** (string)
  generic information about the error
- **error_desc** (string)
  error information for the developer

### 500
any other errors from the server

#### Body: application/json (object)
- **error** (string)
  generic information about the error
- **error_desc** (string)
  error information for the developer


[Powered by Bump.sh](https://bump.sh)