---
title: "Archive a call by call ID"
method: DELETE
path: "/calls/{callId}"
tags: ["calls"]
---

# Archive a call by call ID

`DELETE /calls/{callId}`

Archive a terminated call by its call ID. Archived calls are removed from the default call listing results but remain in the system. This is a soft-delete operation — archived calls can still be retrieved via direct ID lookup.

When a call has multiple CDR entries (due to transfers or IVR routing), archiving by call ID archives **all entries** sharing that `call_id`. To archive a single leg of the call, use `DELETE /calls/{callId}/channels/{channelId}` instead.

**Permission:** `Calls Write` required.

**Monitoring impact:**
- **OFF:** You can only archive calls where you are a participant. Attempting to archive another user's call returns `401`.
- **ON:** You can archive **any call** in the team, regardless of participants.

## Path parameters

- `callId` string, required

## Response `200`

Call successfully archived

## Other responses

- `400` — Invalid call ID format
- `401` — Unauthorized — invalid API key or missing `Calls Write` permission
- `404` — Call not found
- `500` — Internal server error

---

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