---
title: "Bulk-delete phone calls"
method: POST
path: "/public-api/v1/phone_calls/bulk_delete"
tags: ["phone_calls"]
---

# Bulk-delete phone calls

`POST /public-api/v1/phone_calls/bulk_delete`

## Request

- Base URL: `/` (relative, and the document’s source URL is not known)
- URL: `/public-api/v1/phone_calls/bulk_delete`
- Auth: HTTP bearer and API key in header `x-tenant-code`

Delete up to 100 parent phone-call records.

Returns ``204 No Content`` with no response body. The operation is
idempotent, so retrying a completed request is safe. It requires the
caller to have the Public API delete entitlement.

## Request body

- CallBulkDeleteRequest: Request body for ``POST /phone_calls/bulk_delete`` (1 to 100 ids).
  - `calls` CallId[], required: Parent phone-call IDs to delete. 1 to 100 IDs.
    - `id` string, uuid, required

## Response `204`

The requested phone calls were deleted. The response body is empty.

## Other responses

- `400`: The tenant could not be resolved from the request.
- `401`: Error envelope (`public_api.unauthorized`).
- `403`: The request is not allowed for the current tenant or access configuration.
- `404`: Error envelope (`public_api.not_found`).
- `409`: Error envelope (`public_api.conflict`).
- `413`: The request body exceeds the maximum allowed size.
- `422`: Validation Error
- `429`: Rate limit exceeded. Wait for ``Retry-After`` seconds before retrying.
- `502`: Error envelope (`public_api.internal_error`).
- `503`: The request could not be served right now. Please retry.
- `504`: Error envelope (`public_api.request_timeout`).

---

[API](https://skmtc.dev/miitel/apis/miitel-public-api.md) - [All operations](https://skmtc.dev/miitel/apis/miitel-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/miitel/apis/miitel-public-api/revisions/961732756fa3?raw)