---
title: "Cancel a queued call (path-param form)"
method: POST
path: "/conversation/{callId}/cancel"
tags: ["Conversations"]
---

# Cancel a queued call (path-param form)

`POST /conversation/{callId}/cancel`

REST-conventional path-param variant of [`POST /conversation/cancel`](#operation/cancelCallByBody).

**Behavior differs from the body form.** This path-param endpoint only cancels calls that are still in the `IN_QUEUE` state — calls that have already started dialing or are in progress return `400 Bad Request` with `errors: ["Conversation with ID ... is not in queue and cannot be cancelled"]`. Use the body form (`POST /conversation/cancel`) if you need to cancel an in-progress call.

The path param is the `callId` string (e.g. `CALL-1778226705739-7e4c17`), **not** the Mongo `_id`. Passing `_id` returns `404 No conversation found`.

## Path parameters

- `callId` string, required

## Response `200`

Call cancelled.

- object
  - `status` boolean
  - `data` object
    - `callId` string
    - `status` string

## Other responses

- `401` — Unauthorized access
- `404` — No call found with that callId in your organization.
- `500` — Internal server error

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/c2d0eb64b01a/schema)