Back to top

API Documentation

Room

Overview

A Room is basically a place where any number of rechat users (> 1) could chat.

Although the Room is basically a chat room, some other objects could be attached to it. Other concepts of Rechat like Alerts and recommendations are heavily linked to rooms.

It is important to remember that even a private discussion between two people happens on a chat room.

Get a user's Rooms

Get a user's Rooms
GET/rooms

Example URI

GET /rooms
URI Parameters
HideShow
associations
string (required) Example: room.owner,room.latest_message,room.users
Response  200
HideShow
Body
{
  "code": "OK",
  "data": [
    {
      "type": "room",
      "id": "c690bb60-f5e0-4426-80a6-0590fa1e56f8",
      "title": null,
      "owner": null,
      "created_at": 1783014955.922925,
      "updated_at": 1783014955.961906,
      "deleted_at": null,
      "room_type": "Direct",
      "new_notifications": 0,
      "latest_message": {
        "type": "message",
        "mid": "67e8a0ba-59de-468b-af43-ece2f13d3a82",
        "id": "67e8a0ba-59de-468b-af43-ece2f13d3a82",
        "comment": "John invited [email protected] to join.",
        "image_url": null,
        "document_url": null,
        "video_url": null,
        "recommendation": null,
        "author": null,
        "created_at": 1783014955.961906,
        "updated_at": 1783014955.961907,
        "room": "c690bb60-f5e0-4426-80a6-0590fa1e56f8",
        "image_thumbnail_url": null,
        "deleted_at": null,
        "notification": {
          "type": "notification",
          "id": "ef337f5b-f43c-47c2-8ea7-91505a4e8741",
          "object": "c690bb60-f5e0-4426-80a6-0590fa1e56f8",
          "message": "John invited [email protected] to join.",
          "created_at": 1783014955.950733,
          "updated_at": 1783014955.950733,
          "room": "c690bb60-f5e0-4426-80a6-0590fa1e56f8",
          "action": "Invited",
          "object_class": "Room",
          "subject": "248ee6e7-eb6d-438f-a438-df77354caf68",
          "auxiliary_object_class": "User",
          "auxiliary_object": {
            "type": "user",
            "username": null,
            "first_name": "[email protected]",
            "last_name": "",
            "email": "[email protected]",
            "phone_number": null,
            "created_at": 1783014955.892165,
            "id": "e7c040fb-3d9a-4f9b-9d1c-62eb1cfa431f",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1783014955.892183,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": false,
            "timezone": "America/Chicago",
            "user_type": "Client",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": true,
            "personal_room": "d1229b41-01fe-4fea-9225-8a312dbde31b",
            "brand": null,
            "fake_email": null,
            "features": null,
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": null,
            "bio": null,
            "current_time": "12:55 PM - Thursday Jul 02, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "[email protected] ",
            "abbreviated_display_name": "[email protected]",
            "online_state": "Offline",
            "has_password": false
          },
          "recommendation": null,
          "auxiliary_subject": null,
          "subject_class": "User",
          "auxiliary_subject_class": null,
          "extra_subject_class": null,
          "extra_object_class": null,
          "deleted_at": null,
          "specific": null,
          "title": null,
          "data": null,
          "sound": null,
          "app": "rechat",
          "transports": null,
          "phone_number": null,
          "notification_type": "UserInvitedRoom",
          "seen": true,
          "recommendations": null,
          "objects": null,
          "subjects": [
            {
              "type": "user",
              "username": null,
              "first_name": "John",
              "last_name": "Doe",
              "email": "[email protected]",
              "phone_number": "+13626963322",
              "created_at": 1783014955.172807,
              "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
              "address_id": null,
              "cover_image_url": null,
              "profile_image_url": null,
              "updated_at": 1783014955.172826,
              "user_status": "Active",
              "profile_image_thumbnail_url": null,
              "cover_image_thumbnail_url": null,
              "email_confirmed": false,
              "timezone": "America/Chicago",
              "user_type": "Agent",
              "deleted_at": null,
              "phone_confirmed": false,
              "is_shadow": null,
              "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
              "brand": null,
              "fake_email": null,
              "features": null,
              "last_seen_at": null,
              "email_signature": "This is my signature.",
              "daily_enabled": false,
              "email_quota": 30000,
              "website": null,
              "instagram": null,
              "twitter": null,
              "linkedin": null,
              "youtube": null,
              "facebook": null,
              "designation": null,
              "tiktok": null,
              "mfa_enabled": false,
              "xpressdocs_user_id": null,
              "bio": "This is my bio.",
              "current_time": "12:55 PM - Thursday Jul 02, 2026",
              "push_allowed": true,
              "agents": null,
              "last_seen_type": null,
              "active_brand": null,
              "display_name": "John Doe",
              "abbreviated_display_name": "John",
              "online_state": "Offline",
              "has_password": true
            }
          ]
        },
        "reference": null,
        "mentions": null,
        "activity": null,
        "role": null,
        "attachments": [],
        "files": null,
        "email_campaigns": null,
        "contacts": null,
        "crm_tasks": null,
        "compact_listings": null,
        "input_forms": null,
        "artifacts": null,
        "websites": null,
        "social_posts": null,
        "print_campaigns": null,
        "template_instances": null,
        "brand_assets": null,
        "acked_by": null,
        "deliveries": null
      },
      "notification_settings": {
        "248ee6e7-eb6d-438f-a438-df77354caf68": "N_ALL"
      },
      "users": [
        {
          "type": "user",
          "username": null,
          "first_name": "John",
          "last_name": "Doe",
          "email": "[email protected]",
          "phone_number": "+13626963322",
          "created_at": 1783014955.172807,
          "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1783014955.172826,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Agent",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": null,
          "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
          "brand": null,
          "fake_email": null,
          "features": null,
          "last_seen_at": null,
          "email_signature": "This is my signature.",
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "bio": "This is my bio.",
          "current_time": "12:55 PM - Thursday Jul 02, 2026",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "John Doe",
          "abbreviated_display_name": "John",
          "online_state": "Offline",
          "has_password": true
        },
        {
          "type": "user",
          "username": null,
          "first_name": "[email protected]",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": null,
          "created_at": 1783014955.892165,
          "id": "e7c040fb-3d9a-4f9b-9d1c-62eb1cfa431f",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1783014955.892183,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": true,
          "personal_room": "d1229b41-01fe-4fea-9225-8a312dbde31b",
          "brand": null,
          "fake_email": null,
          "features": null,
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "bio": null,
          "current_time": "12:55 PM - Thursday Jul 02, 2026",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "[email protected] ",
          "abbreviated_display_name": "[email protected]",
          "online_state": "Offline",
          "has_password": false
        }
      ],
      "total_alerts": null,
      "total_favorites": null,
      "proposed_title": "[email protected]"
    },
    {
      "type": "room",
      "id": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
      "title": "sampleroom",
      "owner": {
        "type": "user",
        "username": null,
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "phone_number": "+13626963322",
        "created_at": 1783014955.172807,
        "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.172826,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Agent",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": null,
        "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": "This is my signature.",
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": "This is my bio.",
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "John Doe",
        "abbreviated_display_name": "John",
        "online_state": "Offline",
        "has_password": true
      },
      "created_at": 1783014955.514114,
      "updated_at": 1783014955.679798,
      "deleted_at": null,
      "room_type": "Group",
      "new_notifications": 0,
      "latest_message": {
        "type": "message",
        "mid": "1fc3f640-e7c8-4232-9bef-d790c7957de0",
        "id": "1fc3f640-e7c8-4232-9bef-d790c7957de0",
        "comment": "John invited +18598161689 to join.",
        "image_url": null,
        "document_url": null,
        "video_url": null,
        "recommendation": null,
        "author": null,
        "created_at": 1783014955.679798,
        "updated_at": 1783014955.679798,
        "room": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
        "image_thumbnail_url": null,
        "deleted_at": null,
        "notification": {
          "type": "notification",
          "id": "d56bb09d-bfed-40b6-972f-7db260ebf6eb",
          "object": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
          "message": "John invited +18598161689 to join.",
          "created_at": 1783014955.66967,
          "updated_at": 1783014955.66967,
          "room": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
          "action": "Invited",
          "object_class": "Room",
          "subject": "248ee6e7-eb6d-438f-a438-df77354caf68",
          "auxiliary_object_class": "User",
          "auxiliary_object": {
            "type": "user",
            "username": null,
            "first_name": "",
            "last_name": "",
            "email": "[email protected]",
            "phone_number": "+18598161689",
            "created_at": 1783014955.476157,
            "id": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1783014955.47617,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": false,
            "timezone": "America/Chicago",
            "user_type": "Client",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": true,
            "personal_room": "1fe77487-a1d8-4e4f-9f0f-075524c81de8",
            "brand": null,
            "fake_email": true,
            "features": null,
            "last_seen_at": null,
            "email_signature": null,
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": null,
            "bio": null,
            "current_time": "12:55 PM - Thursday Jul 02, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "+18598161689",
            "abbreviated_display_name": "+18598161689",
            "online_state": "Offline",
            "has_password": false
          },
          "recommendation": null,
          "auxiliary_subject": null,
          "subject_class": "User",
          "auxiliary_subject_class": null,
          "extra_subject_class": null,
          "extra_object_class": null,
          "deleted_at": null,
          "specific": null,
          "title": null,
          "data": null,
          "sound": null,
          "app": "rechat",
          "transports": null,
          "phone_number": null,
          "notification_type": "UserInvitedRoom",
          "seen": true,
          "recommendations": null,
          "objects": null,
          "subjects": [
            {
              "type": "user",
              "username": null,
              "first_name": "John",
              "last_name": "Doe",
              "email": "[email protected]",
              "phone_number": "+13626963322",
              "created_at": 1783014955.172807,
              "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
              "address_id": null,
              "cover_image_url": null,
              "profile_image_url": null,
              "updated_at": 1783014955.172826,
              "user_status": "Active",
              "profile_image_thumbnail_url": null,
              "cover_image_thumbnail_url": null,
              "email_confirmed": false,
              "timezone": "America/Chicago",
              "user_type": "Agent",
              "deleted_at": null,
              "phone_confirmed": false,
              "is_shadow": null,
              "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
              "brand": null,
              "fake_email": null,
              "features": null,
              "last_seen_at": null,
              "email_signature": "This is my signature.",
              "daily_enabled": false,
              "email_quota": 30000,
              "website": null,
              "instagram": null,
              "twitter": null,
              "linkedin": null,
              "youtube": null,
              "facebook": null,
              "designation": null,
              "tiktok": null,
              "mfa_enabled": false,
              "xpressdocs_user_id": null,
              "bio": "This is my bio.",
              "current_time": "12:55 PM - Thursday Jul 02, 2026",
              "push_allowed": true,
              "agents": null,
              "last_seen_type": null,
              "active_brand": null,
              "display_name": "John Doe",
              "abbreviated_display_name": "John",
              "online_state": "Offline",
              "has_password": true
            }
          ]
        },
        "reference": null,
        "mentions": null,
        "activity": null,
        "role": null,
        "attachments": [],
        "files": null,
        "email_campaigns": null,
        "contacts": null,
        "crm_tasks": null,
        "compact_listings": null,
        "input_forms": null,
        "artifacts": null,
        "websites": null,
        "social_posts": null,
        "print_campaigns": null,
        "template_instances": null,
        "brand_assets": null,
        "acked_by": null,
        "deliveries": [
          {
            "user": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
            "delivery_type": "sms",
            "type": "notification_delivery",
            "created_at": "2026-07-02T17:55:55.801085+00:00"
          }
        ]
      },
      "notification_settings": {
        "248ee6e7-eb6d-438f-a438-df77354caf68": "N_ALL"
      },
      "users": [
        {
          "type": "user",
          "username": null,
          "first_name": "",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": "+18598161689",
          "created_at": 1783014955.476157,
          "id": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1783014955.47617,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": true,
          "personal_room": "1fe77487-a1d8-4e4f-9f0f-075524c81de8",
          "brand": null,
          "fake_email": true,
          "features": null,
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "bio": null,
          "current_time": "12:55 PM - Thursday Jul 02, 2026",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "+18598161689",
          "abbreviated_display_name": "+18598161689",
          "online_state": "Offline",
          "has_password": false
        },
        {
          "type": "user",
          "username": null,
          "first_name": "John",
          "last_name": "Doe",
          "email": "[email protected]",
          "phone_number": "+13626963322",
          "created_at": 1783014955.172807,
          "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1783014955.172826,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Agent",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": null,
          "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
          "brand": null,
          "fake_email": null,
          "features": null,
          "last_seen_at": null,
          "email_signature": "This is my signature.",
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "bio": "This is my bio.",
          "current_time": "12:55 PM - Thursday Jul 02, 2026",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "John Doe",
          "abbreviated_display_name": "John",
          "online_state": "Offline",
          "has_password": true
        },
        {
          "type": "user",
          "username": null,
          "first_name": "[email protected]",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": null,
          "created_at": 1783014955.474773,
          "id": "5555d900-f6d0-42ff-a684-c45368abad8d",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1783014955.474787,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": true,
          "personal_room": "d7ffb371-6a2c-4a4e-ab32-ab08b743b24d",
          "brand": null,
          "fake_email": null,
          "features": null,
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "bio": null,
          "current_time": "12:55 PM - Thursday Jul 02, 2026",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "[email protected] ",
          "abbreviated_display_name": "[email protected]",
          "online_state": "Offline",
          "has_password": false
        }
      ],
      "total_alerts": null,
      "total_favorites": null,
      "proposed_title": "[email protected], +18598161689"
    }
  ],
  "info": {
    "count": 2,
    "total": 2,
    "new": 0
  }
}

Create Room

Create Room
POST/rooms

Example URI

POST /rooms
URI Parameters
HideShow
associations
string (required) Example: room.owner,room.latest_message,room.users
Request
HideShow
Body
{
  "title": "sampleroom",
  "room_type": "Group",
  "phone_numbers": [
    "+18598161689"
  ],
  "emails": [
    "[email protected]"
  ],
  "owner": "248ee6e7-eb6d-438f-a438-df77354caf68",
  "users": [
    {
      "user_id": "5555d900-f6d0-42ff-a684-c45368abad8d"
    },
    {
      "user_id": "06cc81e5-0092-4fd8-8654-66bb033c36cf"
    }
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "type": "room",
    "id": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
    "title": "sampleroom",
    "owner": {
      "type": "user",
      "username": null,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "+13626963322",
      "created_at": 1783014955.172807,
      "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1783014955.172826,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": false,
      "timezone": "America/Chicago",
      "user_type": "Agent",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": null,
      "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
      "brand": null,
      "fake_email": null,
      "features": null,
      "last_seen_at": null,
      "email_signature": "This is my signature.",
      "daily_enabled": false,
      "email_quota": 30000,
      "website": null,
      "instagram": null,
      "twitter": null,
      "linkedin": null,
      "youtube": null,
      "facebook": null,
      "designation": null,
      "tiktok": null,
      "mfa_enabled": false,
      "xpressdocs_user_id": null,
      "bio": "This is my bio.",
      "current_time": "12:55 PM - Thursday Jul 02, 2026",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": null,
      "display_name": "John Doe",
      "abbreviated_display_name": "John",
      "online_state": "Offline",
      "has_password": true
    },
    "created_at": 1783014955.514114,
    "updated_at": 1783014955.679798,
    "deleted_at": null,
    "room_type": "Group",
    "new_notifications": 0,
    "latest_message": {
      "type": "message",
      "mid": "1fc3f640-e7c8-4232-9bef-d790c7957de0",
      "id": "1fc3f640-e7c8-4232-9bef-d790c7957de0",
      "comment": "John invited +18598161689 to join.",
      "image_url": null,
      "document_url": null,
      "video_url": null,
      "recommendation": null,
      "author": null,
      "created_at": 1783014955.679798,
      "updated_at": 1783014955.679798,
      "room": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
      "image_thumbnail_url": null,
      "deleted_at": null,
      "notification": {
        "type": "notification",
        "id": "d56bb09d-bfed-40b6-972f-7db260ebf6eb",
        "object": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
        "message": "John invited +18598161689 to join.",
        "created_at": 1783014955.66967,
        "updated_at": 1783014955.66967,
        "room": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
        "action": "Invited",
        "object_class": "Room",
        "subject": "248ee6e7-eb6d-438f-a438-df77354caf68",
        "auxiliary_object_class": "User",
        "auxiliary_object": {
          "type": "user",
          "username": null,
          "first_name": "",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": "+18598161689",
          "created_at": 1783014955.476157,
          "id": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1783014955.47617,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": true,
          "personal_room": "1fe77487-a1d8-4e4f-9f0f-075524c81de8",
          "brand": null,
          "fake_email": true,
          "features": null,
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "bio": null,
          "current_time": "12:55 PM - Thursday Jul 02, 2026",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "+18598161689",
          "abbreviated_display_name": "+18598161689",
          "online_state": "Offline",
          "has_password": false
        },
        "recommendation": null,
        "auxiliary_subject": null,
        "subject_class": "User",
        "auxiliary_subject_class": null,
        "extra_subject_class": null,
        "extra_object_class": null,
        "deleted_at": null,
        "specific": null,
        "title": null,
        "data": null,
        "sound": null,
        "app": "rechat",
        "transports": null,
        "phone_number": null,
        "notification_type": "UserInvitedRoom",
        "seen": true,
        "recommendations": null,
        "objects": null,
        "subjects": [
          {
            "type": "user",
            "username": null,
            "first_name": "John",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone_number": "+13626963322",
            "created_at": 1783014955.172807,
            "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1783014955.172826,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": false,
            "timezone": "America/Chicago",
            "user_type": "Agent",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": null,
            "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
            "brand": null,
            "fake_email": null,
            "features": null,
            "last_seen_at": null,
            "email_signature": "This is my signature.",
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": null,
            "bio": "This is my bio.",
            "current_time": "12:55 PM - Thursday Jul 02, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "John Doe",
            "abbreviated_display_name": "John",
            "online_state": "Offline",
            "has_password": true
          }
        ]
      },
      "reference": null,
      "mentions": null,
      "activity": null,
      "role": null,
      "attachments": [],
      "files": null,
      "email_campaigns": null,
      "contacts": null,
      "crm_tasks": null,
      "compact_listings": null,
      "input_forms": null,
      "artifacts": null,
      "websites": null,
      "social_posts": null,
      "print_campaigns": null,
      "template_instances": null,
      "brand_assets": null,
      "acked_by": null,
      "deliveries": [
        {
          "user": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
          "delivery_type": "sms",
          "type": "notification_delivery",
          "created_at": "2026-07-02T17:55:55.801085+00:00"
        }
      ]
    },
    "notification_settings": {
      "248ee6e7-eb6d-438f-a438-df77354caf68": "N_ALL"
    },
    "users": [
      {
        "type": "user",
        "username": null,
        "first_name": "",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": "+18598161689",
        "created_at": 1783014955.476157,
        "id": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.47617,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "1fe77487-a1d8-4e4f-9f0f-075524c81de8",
        "brand": null,
        "fake_email": true,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": null,
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "+18598161689",
        "abbreviated_display_name": "+18598161689",
        "online_state": "Offline",
        "has_password": false
      },
      {
        "type": "user",
        "username": null,
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "phone_number": "+13626963322",
        "created_at": 1783014955.172807,
        "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.172826,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Agent",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": null,
        "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": "This is my signature.",
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": "This is my bio.",
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "John Doe",
        "abbreviated_display_name": "John",
        "online_state": "Offline",
        "has_password": true
      },
      {
        "type": "user",
        "username": null,
        "first_name": "[email protected]",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": null,
        "created_at": 1783014955.474773,
        "id": "5555d900-f6d0-42ff-a684-c45368abad8d",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.474787,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "d7ffb371-6a2c-4a4e-ab32-ab08b743b24d",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": null,
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "[email protected] ",
        "abbreviated_display_name": "[email protected]",
        "online_state": "Offline",
        "has_password": false
      }
    ],
    "total_alerts": null,
    "total_favorites": null,
    "proposed_title": "[email protected], +18598161689"
  }
}

Get Room

Get Room
GET/rooms/{id}

Example URI

GET /rooms/6dd3bfca-cc61-4a11-965e-d6986d08513c
URI Parameters
HideShow
id
string (required) Example: 6dd3bfca-cc61-4a11-965e-d6986d08513c
associations
string (required) Example: room.owner,room.latest_message,room.users
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "type": "room",
    "id": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
    "title": "sampleroom",
    "owner": {
      "type": "user",
      "username": null,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "+13626963322",
      "created_at": 1783014955.172807,
      "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1783014955.172826,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": false,
      "timezone": "America/Chicago",
      "user_type": "Agent",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": null,
      "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
      "brand": null,
      "fake_email": null,
      "features": null,
      "last_seen_at": null,
      "email_signature": "This is my signature.",
      "daily_enabled": false,
      "email_quota": 30000,
      "website": null,
      "instagram": null,
      "twitter": null,
      "linkedin": null,
      "youtube": null,
      "facebook": null,
      "designation": null,
      "tiktok": null,
      "mfa_enabled": false,
      "xpressdocs_user_id": null,
      "bio": "This is my bio.",
      "current_time": "12:55 PM - Thursday Jul 02, 2026",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": null,
      "display_name": "John Doe",
      "abbreviated_display_name": "John",
      "online_state": "Offline",
      "has_password": true
    },
    "created_at": 1783014955.514114,
    "updated_at": 1783014955.679798,
    "deleted_at": null,
    "room_type": "Group",
    "new_notifications": 0,
    "latest_message": {
      "type": "message",
      "mid": "1fc3f640-e7c8-4232-9bef-d790c7957de0",
      "id": "1fc3f640-e7c8-4232-9bef-d790c7957de0",
      "comment": "John invited +18598161689 to join.",
      "image_url": null,
      "document_url": null,
      "video_url": null,
      "recommendation": null,
      "author": null,
      "created_at": 1783014955.679798,
      "updated_at": 1783014955.679798,
      "room": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
      "image_thumbnail_url": null,
      "deleted_at": null,
      "notification": {
        "type": "notification",
        "id": "d56bb09d-bfed-40b6-972f-7db260ebf6eb",
        "object": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
        "message": "John invited +18598161689 to join.",
        "created_at": 1783014955.66967,
        "updated_at": 1783014955.66967,
        "room": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
        "action": "Invited",
        "object_class": "Room",
        "subject": "248ee6e7-eb6d-438f-a438-df77354caf68",
        "auxiliary_object_class": "User",
        "auxiliary_object": {
          "type": "user",
          "username": null,
          "first_name": "",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": "+18598161689",
          "created_at": 1783014955.476157,
          "id": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1783014955.47617,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Client",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": true,
          "personal_room": "1fe77487-a1d8-4e4f-9f0f-075524c81de8",
          "brand": null,
          "fake_email": true,
          "features": null,
          "last_seen_at": null,
          "email_signature": null,
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "bio": null,
          "current_time": "12:55 PM - Thursday Jul 02, 2026",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "+18598161689",
          "abbreviated_display_name": "+18598161689",
          "online_state": "Offline",
          "has_password": false
        },
        "recommendation": null,
        "auxiliary_subject": null,
        "subject_class": "User",
        "auxiliary_subject_class": null,
        "extra_subject_class": null,
        "extra_object_class": null,
        "deleted_at": null,
        "specific": null,
        "title": null,
        "data": null,
        "sound": null,
        "app": "rechat",
        "transports": null,
        "phone_number": null,
        "notification_type": "UserInvitedRoom",
        "seen": true,
        "recommendations": null,
        "objects": null,
        "subjects": [
          {
            "type": "user",
            "username": null,
            "first_name": "John",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone_number": "+13626963322",
            "created_at": 1783014955.172807,
            "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1783014955.172826,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": false,
            "timezone": "America/Chicago",
            "user_type": "Agent",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": null,
            "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
            "brand": null,
            "fake_email": null,
            "features": null,
            "last_seen_at": null,
            "email_signature": "This is my signature.",
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": null,
            "bio": "This is my bio.",
            "current_time": "12:55 PM - Thursday Jul 02, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "John Doe",
            "abbreviated_display_name": "John",
            "online_state": "Offline",
            "has_password": true
          }
        ]
      },
      "reference": null,
      "mentions": null,
      "activity": null,
      "role": null,
      "attachments": [],
      "files": null,
      "email_campaigns": null,
      "contacts": null,
      "crm_tasks": null,
      "compact_listings": null,
      "input_forms": null,
      "artifacts": null,
      "websites": null,
      "social_posts": null,
      "print_campaigns": null,
      "template_instances": null,
      "brand_assets": null,
      "acked_by": null,
      "deliveries": [
        {
          "user": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
          "delivery_type": "sms",
          "type": "notification_delivery",
          "created_at": "2026-07-02T17:55:55.801085+00:00"
        }
      ]
    },
    "notification_settings": {
      "248ee6e7-eb6d-438f-a438-df77354caf68": "N_ALL"
    },
    "users": [
      {
        "type": "user",
        "username": null,
        "first_name": "",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": "+18598161689",
        "created_at": 1783014955.476157,
        "id": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.47617,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "1fe77487-a1d8-4e4f-9f0f-075524c81de8",
        "brand": null,
        "fake_email": true,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": null,
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "+18598161689",
        "abbreviated_display_name": "+18598161689",
        "online_state": "Offline",
        "has_password": false
      },
      {
        "type": "user",
        "username": null,
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "phone_number": "+13626963322",
        "created_at": 1783014955.172807,
        "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.172826,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Agent",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": null,
        "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": "This is my signature.",
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": "This is my bio.",
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "John Doe",
        "abbreviated_display_name": "John",
        "online_state": "Offline",
        "has_password": true
      },
      {
        "type": "user",
        "username": null,
        "first_name": "[email protected]",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": null,
        "created_at": 1783014955.474773,
        "id": "5555d900-f6d0-42ff-a684-c45368abad8d",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.474787,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "d7ffb371-6a2c-4a4e-ab32-ab08b743b24d",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": null,
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "[email protected] ",
        "abbreviated_display_name": "[email protected]",
        "online_state": "Offline",
        "has_password": false
      }
    ],
    "total_alerts": null,
    "total_favorites": null,
    "proposed_title": "[email protected], +18598161689"
  }
}

Add Users to a room

Add Users to a room
POST/rooms/{id}/users

You can add multiple users to a room in the same call

Example URI

POST /rooms/6dd3bfca-cc61-4a11-965e-d6986d08513c/users
URI Parameters
HideShow
id
string (required) Example: 6dd3bfca-cc61-4a11-965e-d6986d08513c
associations
string (required) Example: room.owner,room.latest_message,room.users
Request
HideShow
Body
{
  "users": [
    "a0d996ba-a71e-4b70-acd7-ff68d425ab82"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "type": "room",
    "id": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
    "title": "sampleroom",
    "owner": {
      "type": "user",
      "username": null,
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]",
      "phone_number": "+13626963322",
      "created_at": 1783014955.172807,
      "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1783014955.172826,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": false,
      "timezone": "America/Chicago",
      "user_type": "Agent",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": null,
      "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
      "brand": null,
      "fake_email": null,
      "features": null,
      "last_seen_at": null,
      "email_signature": "This is my signature.",
      "daily_enabled": false,
      "email_quota": 30000,
      "website": null,
      "instagram": null,
      "twitter": null,
      "linkedin": null,
      "youtube": null,
      "facebook": null,
      "designation": null,
      "tiktok": null,
      "mfa_enabled": false,
      "xpressdocs_user_id": null,
      "bio": "This is my bio.",
      "current_time": "12:55 PM - Thursday Jul 02, 2026",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": null,
      "display_name": "John Doe",
      "abbreviated_display_name": "John",
      "online_state": "Offline",
      "has_password": true
    },
    "created_at": 1783014955.514114,
    "updated_at": 1783014956.447047,
    "deleted_at": null,
    "room_type": "Group",
    "new_notifications": 0,
    "latest_message": {
      "type": "message",
      "mid": "66279f38-5e6e-4cca-8e78-4aa4fafd0097",
      "id": "66279f38-5e6e-4cca-8e78-4aa4fafd0097",
      "comment": "John invited John to join.",
      "image_url": null,
      "document_url": null,
      "video_url": null,
      "recommendation": null,
      "author": null,
      "created_at": 1783014956.447047,
      "updated_at": 1783014956.447047,
      "room": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
      "image_thumbnail_url": null,
      "deleted_at": null,
      "notification": {
        "type": "notification",
        "id": "20410af9-e9ec-48cf-a37b-872258e6ad69",
        "object": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
        "message": "John invited John to join.",
        "created_at": 1783014956.436188,
        "updated_at": 1783014956.436188,
        "room": "6dd3bfca-cc61-4a11-965e-d6986d08513c",
        "action": "Invited",
        "object_class": "Room",
        "subject": "248ee6e7-eb6d-438f-a438-df77354caf68",
        "auxiliary_object_class": "User",
        "auxiliary_object": {
          "type": "user",
          "username": null,
          "first_name": "John",
          "last_name": "Doe",
          "email": "[email protected]",
          "phone_number": "+989124834198",
          "created_at": 1783014955.372277,
          "id": "a0d996ba-a71e-4b70-acd7-ff68d425ab82",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1783014955.372292,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": false,
          "timezone": "America/Chicago",
          "user_type": "Agent",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": null,
          "personal_room": "15cec3b4-9dae-4113-b570-3177da9e8523",
          "brand": null,
          "fake_email": null,
          "features": null,
          "last_seen_at": null,
          "email_signature": "This is my signature.",
          "daily_enabled": false,
          "email_quota": 30000,
          "website": null,
          "instagram": null,
          "twitter": null,
          "linkedin": null,
          "youtube": null,
          "facebook": null,
          "designation": null,
          "tiktok": null,
          "mfa_enabled": false,
          "xpressdocs_user_id": null,
          "bio": "This is my bio.",
          "current_time": "12:55 PM - Thursday Jul 02, 2026",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "John Doe",
          "abbreviated_display_name": "John",
          "online_state": "Offline",
          "has_password": true
        },
        "recommendation": null,
        "auxiliary_subject": null,
        "subject_class": "User",
        "auxiliary_subject_class": null,
        "extra_subject_class": null,
        "extra_object_class": null,
        "deleted_at": null,
        "specific": null,
        "title": null,
        "data": null,
        "sound": null,
        "app": "rechat",
        "transports": null,
        "phone_number": null,
        "notification_type": "UserInvitedRoom",
        "seen": true,
        "recommendations": null,
        "objects": null,
        "subjects": [
          {
            "type": "user",
            "username": null,
            "first_name": "John",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone_number": "+13626963322",
            "created_at": 1783014955.172807,
            "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1783014955.172826,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": false,
            "timezone": "America/Chicago",
            "user_type": "Agent",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": null,
            "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
            "brand": null,
            "fake_email": null,
            "features": null,
            "last_seen_at": null,
            "email_signature": "This is my signature.",
            "daily_enabled": false,
            "email_quota": 30000,
            "website": null,
            "instagram": null,
            "twitter": null,
            "linkedin": null,
            "youtube": null,
            "facebook": null,
            "designation": null,
            "tiktok": null,
            "mfa_enabled": false,
            "xpressdocs_user_id": null,
            "bio": "This is my bio.",
            "current_time": "12:55 PM - Thursday Jul 02, 2026",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "John Doe",
            "abbreviated_display_name": "John",
            "online_state": "Offline",
            "has_password": true
          }
        ]
      },
      "reference": null,
      "mentions": null,
      "activity": null,
      "role": null,
      "attachments": [],
      "files": null,
      "email_campaigns": null,
      "contacts": null,
      "crm_tasks": null,
      "compact_listings": null,
      "input_forms": null,
      "artifacts": null,
      "websites": null,
      "social_posts": null,
      "print_campaigns": null,
      "template_instances": null,
      "brand_assets": null,
      "acked_by": null,
      "deliveries": [
        {
          "user": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
          "delivery_type": "sms",
          "type": "notification_delivery",
          "created_at": "2026-07-02T17:55:56.590684+00:00"
        }
      ]
    },
    "notification_settings": {
      "248ee6e7-eb6d-438f-a438-df77354caf68": "N_ALL"
    },
    "users": [
      {
        "type": "user",
        "username": null,
        "first_name": "",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": "+18598161689",
        "created_at": 1783014955.476157,
        "id": "06cc81e5-0092-4fd8-8654-66bb033c36cf",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.47617,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "1fe77487-a1d8-4e4f-9f0f-075524c81de8",
        "brand": null,
        "fake_email": true,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": null,
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "+18598161689",
        "abbreviated_display_name": "+18598161689",
        "online_state": "Offline",
        "has_password": false
      },
      {
        "type": "user",
        "username": null,
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "phone_number": "+13626963322",
        "created_at": 1783014955.172807,
        "id": "248ee6e7-eb6d-438f-a438-df77354caf68",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.172826,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Agent",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": null,
        "personal_room": "a69263a8-d93e-443e-a824-b83bd37e0ec3",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": "This is my signature.",
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": "This is my bio.",
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "John Doe",
        "abbreviated_display_name": "John",
        "online_state": "Offline",
        "has_password": true
      },
      {
        "type": "user",
        "username": null,
        "first_name": "[email protected]",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": null,
        "created_at": 1783014955.474773,
        "id": "5555d900-f6d0-42ff-a684-c45368abad8d",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.474787,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Client",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": true,
        "personal_room": "d7ffb371-6a2c-4a4e-ab32-ab08b743b24d",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": null,
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": null,
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "[email protected] ",
        "abbreviated_display_name": "[email protected]",
        "online_state": "Offline",
        "has_password": false
      },
      {
        "type": "user",
        "username": null,
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "phone_number": "+989124834198",
        "created_at": 1783014955.372277,
        "id": "a0d996ba-a71e-4b70-acd7-ff68d425ab82",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1783014955.372292,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": false,
        "timezone": "America/Chicago",
        "user_type": "Agent",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": null,
        "personal_room": "15cec3b4-9dae-4113-b570-3177da9e8523",
        "brand": null,
        "fake_email": null,
        "features": null,
        "last_seen_at": null,
        "email_signature": "This is my signature.",
        "daily_enabled": false,
        "email_quota": 30000,
        "website": null,
        "instagram": null,
        "twitter": null,
        "linkedin": null,
        "youtube": null,
        "facebook": null,
        "designation": null,
        "tiktok": null,
        "mfa_enabled": false,
        "xpressdocs_user_id": null,
        "bio": "This is my bio.",
        "current_time": "12:55 PM - Thursday Jul 02, 2026",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "John Doe",
        "abbreviated_display_name": "John",
        "online_state": "Offline",
        "has_password": true
      }
    ],
    "total_alerts": null,
    "total_favorites": null,
    "proposed_title": "[email protected], +18598161689, John"
  }
}

Remove user from a room

Remove user from a room
DELETE/rooms/{rid}/users/{id}

Example URI

DELETE /rooms/6dd3bfca-cc61-4a11-965e-d6986d08513c/users/248ee6e7-eb6d-438f-a438-df77354caf68
URI Parameters
HideShow
rid
string (required) Example: 6dd3bfca-cc61-4a11-965e-d6986d08513c
id
string (required) Example: 248ee6e7-eb6d-438f-a438-df77354caf68
Response  204

Archive a room

Archive a room
DELETE/rooms/

Example URI

DELETE /rooms/

Generated by aglio on 02 Jul 2026