Update message session

PUT

/domains/{domain}/users/{user}/messagesessions/{messagesession}

Last modified:2026-10-09 00:40:33

OperationId:UpdateMessageSession

Changes a message session: renames a group session, sets a group chat's participants, or marks your copy read or muted. Every scope reaches its own user. Office Manager reaches every user in its domain, Reseller the domains in its territory, and Super User every domain. Send one shape per request.

Rename the session

Send session-name. Every participant's copy is renamed, and every participant gets a chat-name-change message.

Set the participants

Send messagesession-participants with the complete list of user IDs, including your own, for example 1001@example.com,1002@example.com,1003@example.com. A user added gets the session, and a user left out loses it. The other participants get a chat-participant-add or chat-participant-remove message, and a removed user gets a chat-participant-remove-notification. Use it on a group chat only.

Below Office Manager, only a participant can rename a session or change its participants: your token's user must hold a copy of it, or the answer is 403. Marking read or muted touches only the path user's copy and needs no such check. To leave a group yourself, use PUT /domains/{domain}/users/{user}/messagesessions/{messagesession}/leave.

Mark read or mute

Send messagesession-last-status read after the user has seen the last message, or messagesession-muted yes or no. Only your own copy changes.

A 202 means the change is accepted and applied shortly after, so a read made right away can still show the old values. When you only mark read or muted, a session ID the user does not have changes nothing and still answers 202.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

The change is accepted and applied shortly after this response.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠420Rate Limit Exceeded

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//messagesessions/b1946ac92492d2347c6235b4d2611184' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "session-name": "Front Desk"
}'

Response Example

202 - Rename the session

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-10-09 00:40:33

Send message

Read SMS number

Update message session

Rename the session#

Set the participants#

Mark read or mute#

Request

Responses

Rename the session

Set the participants

Mark read or mute