Messages
Delete Message
Delete a bot-authored message
When to use this
Remove messages that are obsolete, unsafe, or no longer valid.
Endpoint
DELETE /api/bot/v1/messages/{messageId}Auth
Authorization: Bot YOUR_BOT_TOKEN
Request Body
No body.
Response
| Field | Type | Description |
|---|---|---|
ok | boolean | Delete confirmation |
request_id | string | Trace ID |
Errors
| Status | Reason |
|---|---|
401 | Invalid token |
403 | Message not owned by bot |
404 | Message not found |
429 | Rate limited |
cURL
curl -X DELETE https://api.vxil.io/api/bot/v1/messages/msg_123 \
-H "Authorization: Bot YOUR_BOT_TOKEN"TypeScript
await fetch("https://api.vxil.io/api/bot/v1/messages/msg_123", {
method: "DELETE",
headers: { "Authorization": `Bot ${process.env.VXIL_BOT_TOKEN}` },
});Retry behavior
A repeated delete for an already removed message returns 404.