Update a message
POST/chat.update
Edit a previously posted bot message. The updated message can contain plain markdown text or rich Block Kit layouts.
The bot must own the message being updated (matched by address ID). Personal access tokens always send as their bot persona and may only edit messages that personal bot posted.
Access: Organization and Personal.
Required scope: chat:send_message or chat:write
OpenAPI Spec: chat-v1.json
Request
Responses
- 200
- 400
- 401
- 403
- 405
- 413
- 500
Message updated 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) - Both
text/itemsandblocksprovided (mutually exclusive) - An
assetIdwas not found, not owned by your app, or not a file asset - An
assetIdis still processing — retry once its upload completes blocksarray exceeds 10 blocks or 8,000 bytes- Invalid block structure (see Block Kit guide)
- Interactive buttons sent without an Interactivity URL configured
- Invalid
colorvalue - Bot does not own the message
Presented invalid authentication credentials.
Forbidden. The bot lacks access to the target chat.
An unsupported method was requested.
Message content exceeds the maximum allowed size.
An internal error occurred.