Sample - Slack Web API
POST/conversations.mark

Mark a conversation as read

Sets the authenticated user's read cursor in a conversation. Provide the conversation in channel and the timestamp of the most recently seen message in ts, using an authentication token with the conversations:write scope when authorization is required.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 2 body fields
tokenstringoptional
Authentication token for the request; it must provide the `conversations:write` scope.

Optional form-encoded read-cursor details.

channelstringoptional
Channel or conversation to set the read cursor for.
tsnumberoptional
Unique identifier of message you want marked as most recently seen in this conversation.

2 status codes
200Returns a success object with `ok` set to true.
okbooleanrequired
Allowed:true
defaultTypical error response
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:method_not_supported_for_channel_typemissing_scopechannel_not_foundinvalid_timestampnot_in_channelnot_authedinvalid_authaccount_inactiveinvalid_arg_nameinvalid_array_arginvalid_charsetinvalid_form_data
neededstringoptional
okbooleanrequired
Allowed:false
providedstringoptional

Error handling

channel must identify a conversation the authenticated user can access, and ts must be the numeric timestamp of a message in that conversation. The token must provide the conversations:write scope when supplied for authentication.