---
title: "Cancel the queued outbound backlog for the org, an agent, or a team"
method: POST
path: "/v1/voice/outbound/cancel"
tags: ["voice"]
---

# Cancel the queued outbound backlog for the org, an agent, or a team

`POST /v1/voice/outbound/cancel`

## Request body

- CancelRequest
  - `scope` 'org' | 'agent' | 'team', required — The grain to cancel: the whole org, a single agent, or a team.
  - `agent_id` string, uuid, nullable — Required when scope='agent'. Ignored otherwise.
  - `team_id` string, uuid, nullable — Required when scope='team'. Ignored otherwise.

## Response `202`

Successful Response

- BulkCancelAccepted — 202 Accepted response for the async bulk-cancel contract. The exhaustive backlog terminalization + RESERVED recall run to completion in a Celery task (``bulk_cancel_outbound_dispatches``); the HTTP request only accepts the work.
  - `accepted` boolean — Always true on acceptance.
  - `scope` 'org' | 'agent' | 'team', required — The grain that was cancelled.
  - `agent_id` string, uuid, nullable — Set when scope='agent'.
  - `team_id` string, uuid, nullable — Set when scope='team'.

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/oneloop-hq/apis/feather-api.md) · [All operations](https://skmtc.net/oneloop-hq/apis/feather-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneloop-hq/feather-api/revisions/9cd7291d4228/schema)