Delete a message
POST/chat.delete
Delete a previously posted bot message. The bot must own the message being deleted (matched by address ID). Personal access tokens always send as their bot persona and may only delete messages that personal bot posted.
Deleting an already-deleted message is idempotent and returns success.
Access: Organization and Personal.
Required scope: chat:send_message or chat:write
OpenAPI Spec: chat-v1.json
Request
Responses
- 200
- 400
- 401
- 403
- 405
- 500
Message deleted successfully
Bad request. Common causes:
- Invalid chat ID
- Invalid or missing
timestamp - A
senderfield was provided — the sender is derived from the original message (see Sender Profiles) - Bot does not own the message
Presented invalid authentication credentials.
Forbidden. The bot lacks access to the target chat.
An unsupported method was requested.
An internal error occurred.