---
title: "DELETE /threads/{threadId}/messages/{messageId}"
method: DELETE
path: "/threads/{threadId}/messages/{messageId}"
---

# DELETE /threads/{threadId}/messages/{messageId}

`DELETE /threads/{threadId}/messages/{messageId}`

Deletes an existing message on an existing thread.

## Path parameters

- `threadId` string, required
- `messageId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- MessageDeletionStatus — The status of a thread message deletion operation.
  - `id` string, required — The ID of the resource specified for deletion.
  - `deleted` boolean, required — A value indicating whether deletion was successful.
  - `object` 'thread.message.deleted', required — The object type, which is always 'thread.message.deleted'.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2025-05-01) `12ccf656f42a` — 1 breaking
  - api removed without deprecation
- **2026-07-13** (2025-05-01) `9cca81a04592` — 1 info
  - endpoint added
- **2025-05-14** (2025-05-01) `270b72f9e3e7` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/azure/apis/ai-azure-ai-agents/changes/threads/:threadId/messages/:messageId/delete.md)

---

[API](https://skmtc.dev/azure/apis/ai-azure-ai-agents.md) · [All operations](https://skmtc.dev/azure/apis/ai-azure-ai-agents/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/ai-azure-ai-agents/revisions/de4a99f09829/schema)