---
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.

---

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