---
title: "Submits request to cancel an existing job by Id while supplying free-form cancellation reason."
method: POST
path: "/routing/jobs/{jobId}:cancel"
---

# Submits request to cancel an existing job by Id while supplying free-form cancellation reason.

`POST /routing/jobs/{jobId}:cancel`

Submits request to cancel an existing job by Id while supplying free-form cancellation reason.

## Path parameters

- `jobId` string, required

## Query parameters

- `api-version` string, required

## Request body

- CancelJobOptions — Request payload for cancelling a job.
  - `note` string — A note that will be appended to a job's Notes collection with the current timestamp.
  - `dispositionCode` string — Indicates the outcome of a job, populate this field with your own custom values. If not provided, default value of "Cancelled" is set.

## Response `200`

The request has succeeded.

- CancelJobResult — Response payload from cancelling a job.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/communication-jobrouter.md) · [All operations](https://skmtc.net/azure/apis/communication-jobrouter/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/communication-jobrouter/revisions/c06e8f55d8b7/schema)