# Soft-delete a message

**`DELETE https://myagentmail.com/v1/inboxes/{id}/messages/{messageId}`**

Group: Messages
Operation ID: `deleteMessage`

Sets `deleted_at`. The row stays so thread history doesn't renumber; list queries filter deleted messages out.

## Path parameters

- `id` (string, required) — Inbox UUID
- `messageId` (string, required) — Message UUID

## Responses

### 200 — Deleted

## Code samples

### TypeScript

```typescript
import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// DELETE /v1/inboxes/{id}/messages/{messageId}
const result = await client.request("delete", "/v1/inboxes/{id}/messages/{messageId}", { params: { id: "00000000-0000-0000-0000-000000000000", messageId: "00000000-0000-0000-0000-000000000000" } });
```

### curl

```bash
curl -X DELETE 'https://myagentmail.com/v1/inboxes/00000000-0000-0000-0000-000000000000/messages/00000000-0000-0000-0000-000000000000' \
  -H 'X-API-Key: $MYAGENTMAIL_API_KEY'
```

### Python

```python
import os, requests

r = requests.delete(
    "https://myagentmail.com/v1/inboxes/00000000-0000-0000-0000-000000000000/messages/00000000-0000-0000-0000-000000000000",
    headers={"X-API-Key": os.environ["MYAGENTMAIL_API_KEY"]},
)
r.raise_for_status()
print(r.json())
```