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": "54cd6a2a-9ade-4c43-8aff-68327f00b2c3",
      "title": null,
      "owner": null,
      "created_at": 1760470100.630393,
      "updated_at": 1760470100.675413,
      "deleted_at": null,
      "room_type": "Direct",
      "new_notifications": 0,
      "latest_message": {
        "type": "message",
        "mid": "957ff31a-1654-45de-a889-d3aebd3cf3ad",
        "id": "957ff31a-1654-45de-a889-d3aebd3cf3ad",
        "comment": "Unit invited [email protected] to join.",
        "image_url": null,
        "document_url": null,
        "video_url": null,
        "recommendation": null,
        "author": null,
        "created_at": 1760470100.675413,
        "updated_at": 1760470100.675413,
        "room": "54cd6a2a-9ade-4c43-8aff-68327f00b2c3",
        "image_thumbnail_url": null,
        "deleted_at": null,
        "notification": {
          "type": "notification",
          "id": "bcbbc7e9-54a6-4105-b2ee-50e70d14c7bc",
          "object": "54cd6a2a-9ade-4c43-8aff-68327f00b2c3",
          "message": "Unit invited [email protected] to join.",
          "created_at": 1760470100.663767,
          "updated_at": 1760470100.663767,
          "room": "54cd6a2a-9ade-4c43-8aff-68327f00b2c3",
          "action": "Invited",
          "object_class": "Room",
          "subject": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "auxiliary_object_class": "User",
          "auxiliary_object": {
            "type": "user",
            "username": null,
            "first_name": "[email protected]",
            "last_name": "",
            "email": "[email protected]",
            "phone_number": null,
            "created_at": 1760470100.546014,
            "id": "eefc1780-240a-4204-87b0-b0e7454de29b",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1760470100.546036,
            "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": "90a7d47e-dbf4-4576-9aa2-2689436c5e25",
            "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,
            "current_time": "2:28 PM - Tuesday Oct 14, 2025",
            "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": "Unit",
              "last_name": "Test",
              "email": "[email protected]",
              "phone_number": "+4368120265807",
              "created_at": 1493115498.770362,
              "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "address_id": null,
              "cover_image_url": null,
              "profile_image_url": null,
              "updated_at": 1493115498.770744,
              "user_status": "Active",
              "profile_image_thumbnail_url": null,
              "cover_image_thumbnail_url": null,
              "email_confirmed": true,
              "timezone": "America/Chicago",
              "user_type": "Admin",
              "deleted_at": null,
              "phone_confirmed": false,
              "is_shadow": false,
              "personal_room": null,
              "brand": null,
              "fake_email": false,
              "features": [
                "Deals"
              ],
              "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,
              "current_time": "2:28 PM - Tuesday Oct 14, 2025",
              "push_allowed": true,
              "agents": null,
              "last_seen_type": null,
              "active_brand": null,
              "display_name": "Unit Test",
              "abbreviated_display_name": "Unit",
              "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,
        "websites": null,
        "social_posts": null,
        "print_campaigns": null,
        "template_instances": null,
        "brand_assets": null,
        "acked_by": null,
        "deliveries": null
      },
      "notification_settings": {
        "80a227b2-29a0-11e7-b636-e4a7a08e15d4": "N_ALL"
      },
      "users": [
        {
          "type": "user",
          "username": null,
          "first_name": "Unit",
          "last_name": "Test",
          "email": "[email protected]",
          "phone_number": "+4368120265807",
          "created_at": 1493115498.770362,
          "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1493115498.770744,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": true,
          "timezone": "America/Chicago",
          "user_type": "Admin",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": false,
          "personal_room": null,
          "brand": null,
          "fake_email": false,
          "features": [
            "Deals"
          ],
          "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,
          "current_time": "2:28 PM - Tuesday Oct 14, 2025",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "Unit Test",
          "abbreviated_display_name": "Unit",
          "online_state": "Offline",
          "has_password": true
        },
        {
          "type": "user",
          "username": null,
          "first_name": "[email protected]",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": null,
          "created_at": 1760470100.546014,
          "id": "eefc1780-240a-4204-87b0-b0e7454de29b",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1760470100.546036,
          "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": "90a7d47e-dbf4-4576-9aa2-2689436c5e25",
          "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,
          "current_time": "2:28 PM - Tuesday Oct 14, 2025",
          "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": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
      "title": "sampleroom",
      "owner": {
        "type": "user",
        "username": null,
        "first_name": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      },
      "created_at": 1760470100.034254,
      "updated_at": 1760470100.282159,
      "deleted_at": null,
      "room_type": "Group",
      "new_notifications": 0,
      "latest_message": {
        "type": "message",
        "mid": "f584f2ba-549d-4205-b6ec-955ca6f9044c",
        "id": "f584f2ba-549d-4205-b6ec-955ca6f9044c",
        "comment": "Unit invited +18598161689 to join.",
        "image_url": null,
        "document_url": null,
        "video_url": null,
        "recommendation": null,
        "author": null,
        "created_at": 1760470100.282159,
        "updated_at": 1760470100.282159,
        "room": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
        "image_thumbnail_url": null,
        "deleted_at": null,
        "notification": {
          "type": "notification",
          "id": "557fa8f0-d5e5-482e-9871-75007987d042",
          "object": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
          "message": "Unit invited +18598161689 to join.",
          "created_at": 1760470100.26935,
          "updated_at": 1760470100.26935,
          "room": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
          "action": "Invited",
          "object_class": "Room",
          "subject": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "auxiliary_object_class": "User",
          "auxiliary_object": {
            "type": "user",
            "username": null,
            "first_name": "",
            "last_name": "",
            "email": "[email protected]",
            "phone_number": "+18598161689",
            "created_at": 1760470099.90224,
            "id": "2eb03f3a-77c1-4ee9-835d-d37414573762",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1760470099.902257,
            "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": "83261622-6d25-4dbe-bbcd-d220f3a75f47",
            "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,
            "current_time": "2:28 PM - Tuesday Oct 14, 2025",
            "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": "Unit",
              "last_name": "Test",
              "email": "[email protected]",
              "phone_number": "+4368120265807",
              "created_at": 1493115498.770362,
              "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
              "address_id": null,
              "cover_image_url": null,
              "profile_image_url": null,
              "updated_at": 1493115498.770744,
              "user_status": "Active",
              "profile_image_thumbnail_url": null,
              "cover_image_thumbnail_url": null,
              "email_confirmed": true,
              "timezone": "America/Chicago",
              "user_type": "Admin",
              "deleted_at": null,
              "phone_confirmed": false,
              "is_shadow": false,
              "personal_room": null,
              "brand": null,
              "fake_email": false,
              "features": [
                "Deals"
              ],
              "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,
              "current_time": "2:28 PM - Tuesday Oct 14, 2025",
              "push_allowed": true,
              "agents": null,
              "last_seen_type": null,
              "active_brand": null,
              "display_name": "Unit Test",
              "abbreviated_display_name": "Unit",
              "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,
        "websites": null,
        "social_posts": null,
        "print_campaigns": null,
        "template_instances": null,
        "brand_assets": null,
        "acked_by": null,
        "deliveries": [
          {
            "user": "2eb03f3a-77c1-4ee9-835d-d37414573762",
            "delivery_type": "sms",
            "type": "notification_delivery",
            "created_at": "2025-10-14T19:28:20.463109+00:00"
          }
        ]
      },
      "notification_settings": {
        "80a227b2-29a0-11e7-b636-e4a7a08e15d4": "N_ALL"
      },
      "users": [
        {
          "type": "user",
          "username": null,
          "first_name": "",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": "+18598161689",
          "created_at": 1760470099.90224,
          "id": "2eb03f3a-77c1-4ee9-835d-d37414573762",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1760470099.902257,
          "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": "83261622-6d25-4dbe-bbcd-d220f3a75f47",
          "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,
          "current_time": "2:28 PM - Tuesday Oct 14, 2025",
          "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": "[email protected]",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": null,
          "created_at": 1760470099.897663,
          "id": "7f6c6c4e-5338-4d4f-929e-a16993cccf2a",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1760470099.897686,
          "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": "c6ae8082-e824-4be1-b47e-52c581c5eda4",
          "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,
          "current_time": "2:28 PM - Tuesday Oct 14, 2025",
          "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": "Unit",
          "last_name": "Test",
          "email": "[email protected]",
          "phone_number": "+4368120265807",
          "created_at": 1493115498.770362,
          "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1493115498.770744,
          "user_status": "Active",
          "profile_image_thumbnail_url": null,
          "cover_image_thumbnail_url": null,
          "email_confirmed": true,
          "timezone": "America/Chicago",
          "user_type": "Admin",
          "deleted_at": null,
          "phone_confirmed": false,
          "is_shadow": false,
          "personal_room": null,
          "brand": null,
          "fake_email": false,
          "features": [
            "Deals"
          ],
          "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,
          "current_time": "2:28 PM - Tuesday Oct 14, 2025",
          "push_allowed": true,
          "agents": null,
          "last_seen_type": null,
          "active_brand": null,
          "display_name": "Unit Test",
          "abbreviated_display_name": "Unit",
          "online_state": "Offline",
          "has_password": true
        }
      ],
      "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": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
  "users": [
    {
      "user_id": "7f6c6c4e-5338-4d4f-929e-a16993cccf2a"
    },
    {
      "user_id": "2eb03f3a-77c1-4ee9-835d-d37414573762"
    }
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "type": "room",
    "id": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
    "title": "sampleroom",
    "owner": {
      "type": "user",
      "username": null,
      "first_name": "Unit",
      "last_name": "Test",
      "email": "[email protected]",
      "phone_number": "+4368120265807",
      "created_at": 1493115498.770362,
      "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1493115498.770744,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": true,
      "timezone": "America/Chicago",
      "user_type": "Admin",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": false,
      "personal_room": null,
      "brand": null,
      "fake_email": false,
      "features": [
        "Deals"
      ],
      "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,
      "current_time": "2:28 PM - Tuesday Oct 14, 2025",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": null,
      "display_name": "Unit Test",
      "abbreviated_display_name": "Unit",
      "online_state": "Offline",
      "has_password": true
    },
    "created_at": 1760470100.034254,
    "updated_at": 1760470100.282159,
    "deleted_at": null,
    "room_type": "Group",
    "new_notifications": 0,
    "latest_message": {
      "type": "message",
      "mid": "f584f2ba-549d-4205-b6ec-955ca6f9044c",
      "id": "f584f2ba-549d-4205-b6ec-955ca6f9044c",
      "comment": "Unit invited +18598161689 to join.",
      "image_url": null,
      "document_url": null,
      "video_url": null,
      "recommendation": null,
      "author": null,
      "created_at": 1760470100.282159,
      "updated_at": 1760470100.282159,
      "room": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
      "image_thumbnail_url": null,
      "deleted_at": null,
      "notification": {
        "type": "notification",
        "id": "557fa8f0-d5e5-482e-9871-75007987d042",
        "object": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
        "message": "Unit invited +18598161689 to join.",
        "created_at": 1760470100.26935,
        "updated_at": 1760470100.26935,
        "room": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
        "action": "Invited",
        "object_class": "Room",
        "subject": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "auxiliary_object_class": "User",
        "auxiliary_object": {
          "type": "user",
          "username": null,
          "first_name": "",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": "+18598161689",
          "created_at": 1760470099.90224,
          "id": "2eb03f3a-77c1-4ee9-835d-d37414573762",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1760470099.902257,
          "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": "83261622-6d25-4dbe-bbcd-d220f3a75f47",
          "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,
          "current_time": "2:28 PM - Tuesday Oct 14, 2025",
          "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": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "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,
            "current_time": "2:28 PM - Tuesday Oct 14, 2025",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "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,
      "websites": null,
      "social_posts": null,
      "print_campaigns": null,
      "template_instances": null,
      "brand_assets": null,
      "acked_by": null,
      "deliveries": [
        {
          "user": "2eb03f3a-77c1-4ee9-835d-d37414573762",
          "delivery_type": "sms",
          "type": "notification_delivery",
          "created_at": "2025-10-14T19:28:20.463109+00:00"
        }
      ]
    },
    "notification_settings": {
      "80a227b2-29a0-11e7-b636-e4a7a08e15d4": "N_ALL"
    },
    "users": [
      {
        "type": "user",
        "username": null,
        "first_name": "",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": "+18598161689",
        "created_at": 1760470099.90224,
        "id": "2eb03f3a-77c1-4ee9-835d-d37414573762",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1760470099.902257,
        "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": "83261622-6d25-4dbe-bbcd-d220f3a75f47",
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "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": "[email protected]",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": null,
        "created_at": 1760470099.897663,
        "id": "7f6c6c4e-5338-4d4f-929e-a16993cccf2a",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1760470099.897686,
        "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": "c6ae8082-e824-4be1-b47e-52c581c5eda4",
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "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": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      }
    ],
    "total_alerts": null,
    "total_favorites": null,
    "proposed_title": "[email protected], +18598161689"
  }
}

Get Room

Get Room
GET/rooms/{id}

Example URI

GET /rooms/eb2e2c4b-34de-46f3-90fe-129fae5566ef
URI Parameters
HideShow
id
string (required) Example: eb2e2c4b-34de-46f3-90fe-129fae5566ef
associations
string (required) Example: room.owner,room.latest_message,room.users
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "type": "room",
    "id": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
    "title": "sampleroom",
    "owner": {
      "type": "user",
      "username": null,
      "first_name": "Unit",
      "last_name": "Test",
      "email": "[email protected]",
      "phone_number": "+4368120265807",
      "created_at": 1493115498.770362,
      "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1493115498.770744,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": true,
      "timezone": "America/Chicago",
      "user_type": "Admin",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": false,
      "personal_room": null,
      "brand": null,
      "fake_email": false,
      "features": [
        "Deals"
      ],
      "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,
      "current_time": "2:28 PM - Tuesday Oct 14, 2025",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": null,
      "display_name": "Unit Test",
      "abbreviated_display_name": "Unit",
      "online_state": "Offline",
      "has_password": true
    },
    "created_at": 1760470100.034254,
    "updated_at": 1760470100.282159,
    "deleted_at": null,
    "room_type": "Group",
    "new_notifications": 0,
    "latest_message": {
      "type": "message",
      "mid": "f584f2ba-549d-4205-b6ec-955ca6f9044c",
      "id": "f584f2ba-549d-4205-b6ec-955ca6f9044c",
      "comment": "Unit invited +18598161689 to join.",
      "image_url": null,
      "document_url": null,
      "video_url": null,
      "recommendation": null,
      "author": null,
      "created_at": 1760470100.282159,
      "updated_at": 1760470100.282159,
      "room": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
      "image_thumbnail_url": null,
      "deleted_at": null,
      "notification": {
        "type": "notification",
        "id": "557fa8f0-d5e5-482e-9871-75007987d042",
        "object": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
        "message": "Unit invited +18598161689 to join.",
        "created_at": 1760470100.26935,
        "updated_at": 1760470100.26935,
        "room": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
        "action": "Invited",
        "object_class": "Room",
        "subject": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "auxiliary_object_class": "User",
        "auxiliary_object": {
          "type": "user",
          "username": null,
          "first_name": "",
          "last_name": "",
          "email": "[email protected]",
          "phone_number": "+18598161689",
          "created_at": 1760470099.90224,
          "id": "2eb03f3a-77c1-4ee9-835d-d37414573762",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1760470099.902257,
          "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": "83261622-6d25-4dbe-bbcd-d220f3a75f47",
          "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,
          "current_time": "2:28 PM - Tuesday Oct 14, 2025",
          "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": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "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,
            "current_time": "2:28 PM - Tuesday Oct 14, 2025",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "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,
      "websites": null,
      "social_posts": null,
      "print_campaigns": null,
      "template_instances": null,
      "brand_assets": null,
      "acked_by": null,
      "deliveries": [
        {
          "user": "2eb03f3a-77c1-4ee9-835d-d37414573762",
          "delivery_type": "sms",
          "type": "notification_delivery",
          "created_at": "2025-10-14T19:28:20.463109+00:00"
        }
      ]
    },
    "notification_settings": {
      "80a227b2-29a0-11e7-b636-e4a7a08e15d4": "N_ALL"
    },
    "users": [
      {
        "type": "user",
        "username": null,
        "first_name": "",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": "+18598161689",
        "created_at": 1760470099.90224,
        "id": "2eb03f3a-77c1-4ee9-835d-d37414573762",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1760470099.902257,
        "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": "83261622-6d25-4dbe-bbcd-d220f3a75f47",
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "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": "[email protected]",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": null,
        "created_at": 1760470099.897663,
        "id": "7f6c6c4e-5338-4d4f-929e-a16993cccf2a",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1760470099.897686,
        "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": "c6ae8082-e824-4be1-b47e-52c581c5eda4",
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "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": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      }
    ],
    "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/eb2e2c4b-34de-46f3-90fe-129fae5566ef/users
URI Parameters
HideShow
id
string (required) Example: eb2e2c4b-34de-46f3-90fe-129fae5566ef
associations
string (required) Example: room.owner,room.latest_message,room.users
Request
HideShow
Body
{
  "users": [
    "bc2ac0ca-61dc-4acd-aef7-112879883eb9"
  ]
}
Response  200
HideShow
Body
{
  "code": "OK",
  "data": {
    "type": "room",
    "id": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
    "title": "sampleroom",
    "owner": {
      "type": "user",
      "username": null,
      "first_name": "Unit",
      "last_name": "Test",
      "email": "[email protected]",
      "phone_number": "+4368120265807",
      "created_at": 1493115498.770362,
      "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
      "address_id": null,
      "cover_image_url": null,
      "profile_image_url": null,
      "updated_at": 1493115498.770744,
      "user_status": "Active",
      "profile_image_thumbnail_url": null,
      "cover_image_thumbnail_url": null,
      "email_confirmed": true,
      "timezone": "America/Chicago",
      "user_type": "Admin",
      "deleted_at": null,
      "phone_confirmed": false,
      "is_shadow": false,
      "personal_room": null,
      "brand": null,
      "fake_email": false,
      "features": [
        "Deals"
      ],
      "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,
      "current_time": "2:28 PM - Tuesday Oct 14, 2025",
      "push_allowed": true,
      "agents": null,
      "last_seen_type": null,
      "active_brand": null,
      "display_name": "Unit Test",
      "abbreviated_display_name": "Unit",
      "online_state": "Offline",
      "has_password": true
    },
    "created_at": 1760470100.034254,
    "updated_at": 1760470101.202391,
    "deleted_at": null,
    "room_type": "Group",
    "new_notifications": 0,
    "latest_message": {
      "type": "message",
      "mid": "50148352-b3f3-4f1a-8dfe-c3e372550438",
      "id": "50148352-b3f3-4f1a-8dfe-c3e372550438",
      "comment": "Unit invited John to join.",
      "image_url": null,
      "document_url": null,
      "video_url": null,
      "recommendation": null,
      "author": null,
      "created_at": 1760470101.202391,
      "updated_at": 1760470101.202391,
      "room": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
      "image_thumbnail_url": null,
      "deleted_at": null,
      "notification": {
        "type": "notification",
        "id": "3ca19f29-6124-482a-91dc-60f6697d8955",
        "object": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
        "message": "Unit invited John to join.",
        "created_at": 1760470101.186039,
        "updated_at": 1760470101.186039,
        "room": "eb2e2c4b-34de-46f3-90fe-129fae5566ef",
        "action": "Invited",
        "object_class": "Room",
        "subject": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "auxiliary_object_class": "User",
        "auxiliary_object": {
          "type": "user",
          "username": null,
          "first_name": "John",
          "last_name": "Doe",
          "email": "[email protected]",
          "phone_number": "+989124834198",
          "created_at": 1760470099.730634,
          "id": "bc2ac0ca-61dc-4acd-aef7-112879883eb9",
          "address_id": null,
          "cover_image_url": null,
          "profile_image_url": null,
          "updated_at": 1760470099.730663,
          "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": null,
          "personal_room": "a1752a90-bf4a-4d87-980a-d8d5b980c49f",
          "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,
          "current_time": "2:28 PM - Tuesday Oct 14, 2025",
          "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": "Unit",
            "last_name": "Test",
            "email": "[email protected]",
            "phone_number": "+4368120265807",
            "created_at": 1493115498.770362,
            "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
            "address_id": null,
            "cover_image_url": null,
            "profile_image_url": null,
            "updated_at": 1493115498.770744,
            "user_status": "Active",
            "profile_image_thumbnail_url": null,
            "cover_image_thumbnail_url": null,
            "email_confirmed": true,
            "timezone": "America/Chicago",
            "user_type": "Admin",
            "deleted_at": null,
            "phone_confirmed": false,
            "is_shadow": false,
            "personal_room": null,
            "brand": null,
            "fake_email": false,
            "features": [
              "Deals"
            ],
            "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,
            "current_time": "2:28 PM - Tuesday Oct 14, 2025",
            "push_allowed": true,
            "agents": null,
            "last_seen_type": null,
            "active_brand": null,
            "display_name": "Unit Test",
            "abbreviated_display_name": "Unit",
            "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,
      "websites": null,
      "social_posts": null,
      "print_campaigns": null,
      "template_instances": null,
      "brand_assets": null,
      "acked_by": null,
      "deliveries": [
        {
          "user": "2eb03f3a-77c1-4ee9-835d-d37414573762",
          "delivery_type": "sms",
          "type": "notification_delivery",
          "created_at": "2025-10-14T19:28:21.430915+00:00"
        }
      ]
    },
    "notification_settings": {
      "80a227b2-29a0-11e7-b636-e4a7a08e15d4": "N_ALL"
    },
    "users": [
      {
        "type": "user",
        "username": null,
        "first_name": "",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": "+18598161689",
        "created_at": 1760470099.90224,
        "id": "2eb03f3a-77c1-4ee9-835d-d37414573762",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1760470099.902257,
        "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": "83261622-6d25-4dbe-bbcd-d220f3a75f47",
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "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": "[email protected]",
        "last_name": "",
        "email": "[email protected]",
        "phone_number": null,
        "created_at": 1760470099.897663,
        "id": "7f6c6c4e-5338-4d4f-929e-a16993cccf2a",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1760470099.897686,
        "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": "c6ae8082-e824-4be1-b47e-52c581c5eda4",
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "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": "Unit",
        "last_name": "Test",
        "email": "[email protected]",
        "phone_number": "+4368120265807",
        "created_at": 1493115498.770362,
        "id": "80a227b2-29a0-11e7-b636-e4a7a08e15d4",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1493115498.770744,
        "user_status": "Active",
        "profile_image_thumbnail_url": null,
        "cover_image_thumbnail_url": null,
        "email_confirmed": true,
        "timezone": "America/Chicago",
        "user_type": "Admin",
        "deleted_at": null,
        "phone_confirmed": false,
        "is_shadow": false,
        "personal_room": null,
        "brand": null,
        "fake_email": false,
        "features": [
          "Deals"
        ],
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "push_allowed": true,
        "agents": null,
        "last_seen_type": null,
        "active_brand": null,
        "display_name": "Unit Test",
        "abbreviated_display_name": "Unit",
        "online_state": "Offline",
        "has_password": true
      },
      {
        "type": "user",
        "username": null,
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "phone_number": "+989124834198",
        "created_at": 1760470099.730634,
        "id": "bc2ac0ca-61dc-4acd-aef7-112879883eb9",
        "address_id": null,
        "cover_image_url": null,
        "profile_image_url": null,
        "updated_at": 1760470099.730663,
        "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": null,
        "personal_room": "a1752a90-bf4a-4d87-980a-d8d5b980c49f",
        "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,
        "current_time": "2:28 PM - Tuesday Oct 14, 2025",
        "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/eb2e2c4b-34de-46f3-90fe-129fae5566ef/users/80a227b2-29a0-11e7-b636-e4a7a08e15d4
URI Parameters
HideShow
rid
string (required) Example: eb2e2c4b-34de-46f3-90fe-129fae5566ef
id
string (required) Example: 80a227b2-29a0-11e7-b636-e4a7a08e15d4
Response  204

Archive a room

Archive a room
DELETE/rooms/

Example URI

DELETE /rooms/

Generated by aglio on 14 Oct 2025