---
title: "Permanently archive a message (level 2)"
method: DELETE
path: "/conversations/{convId}/messages/{messageId}/archive"
tags: ["messages"]
---

# Permanently archive a message (level 2)

`DELETE /conversations/{convId}/messages/{messageId}/archive`

Performs a **level-2 (permanent) archive** on a specific message within a conversation. This operation is **irreversible** and requires Monitoring to be enabled on your API key.

Unlike level-1 archive (`POST .../archive`), which is soft and reversible via `/unarchive`, level-2 archive permanently removes the message. Returns `401` if Monitoring is OFF.

**Permission:** `Conversations Write` required.

**Monitoring:** **Required.** Returns `401` if Monitoring is OFF.

## Path parameters

- `convId` integer, required
- `messageId` integer, required

## Response `200`

Message permanently archived (level 2 — irreversible).

## Other responses

- `400` — Invalid conversation or message ID format.
- `401` — Unauthorized — missing or invalid API token, missing `Conversations Write` permission, or Monitoring is not enabled (required for level-2 archive).
- `404` — Conversation or message not found.

---

[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)