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 are not supported for this endpoint.
Deleting an already-deleted message is idempotent and returns success.
Access: Organization only.
Required scope: chat:send_message or chat:write
OpenAPI Spec: chat.json
Request
Responses
- 200
- 400
- 401
- 403
- 405
- 500
Message deleted successfully
Bad request. Common causes:
- Invalid chat ID
- Invalid or missing
timestamp - Personal access token used (not supported)
- 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 occured.