---
title: "Deprecated Parameters"
slug: "deprecatedparameters"
updated: 2025-12-19T07:11:00Z
published: 2025-12-19T07:11:00Z
canonical: "developer.rocket.chat/deprecatedparameters"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Deprecated Parameters

This document outlines the parameters deprecated in Rocket.Chat’s REST API endpoints and Realtime API methods. Some of these parameters have already been removed, while others are scheduled for removal in upcoming releases. To ensure continued functionality, adopt the recommended alternatives specified for each affected parameter.

### REST API

The table below shows the deprecated parameters in our REST API endpoints:

- **API parameter removals**: The following parameters have been permanently removed from their respective API endpoints in v8.0.0:

| Name | Parameter affected | Description | Deprecated since | Removed in version |
| --- | --- | --- | --- | --- |
| [engagement-dashboard/channels/list](https://developer.rocket.chat/apidocs/get-channels-engagement) | `hideRoomsWithNoActivity` | The endpoint no longer accepts `hideRoomsWithNoActivity` parameter. By default, inactive rooms will be excluded from the response. | 6.11.0 | 8.0.0 |
| [oauth-apps.get](https://developer.rocket.chat/apidocs/get-oauth-app) | `appId` | This parameter will no longer be accepted (use clientId or _id instead). | 6.0.0 | 8.0.0 |
| [roles.getUsersInRole](https://developer.rocket.chat/apidocs/get-users-of-a-role) | `role` | The **role** parameter will still be used, but its value must now always be the **role ID**. Querying with the role name as value is deprecated. | 4.6.0 | 8.0.0 |
| [roles.addUserToRole](https://developer.rocket.chat/apidocs/assign-role-to-user) | `roleName` | This parameter will no longer be accepted. Use `roleId` instead. | 4.6.0 | 8.0.0 |
| [roles.removeUserFromRole](https://developer.rocket.chat/apidocs/remove-role-from-user) | `roleName` | This parameter will no longer be accepted. Use `roleId` instead. | 4.6.0 | 8.0.0 |

#### Query and fields query parameters

The `query` and `fields` [parameters](/apidocs/query-parameters#query-and-fields) have **been deprecated since version 5.0.0** across all supported endpoints to prevent malicious queries. They are **disabled by default from version 7.0.0** and can only be enabled by setting the `ALLOW_UNSAFE_QUERY_AND_FIELDS_API_PARAMS: true` [environment variable](https://docs.rocket.chat/docs/deployment-environment-variables) in your deployment configuration.

> [!CAUTION]
> Enabling these parameters may expose your workspace to security risks, and Rocket.Chat is not responsible for any resulting vulnerabilities. Proceed with caution and ensure proper security measures are in place.

When enabled, a deprecation message is included in the response header as `X-Deprecation-Message`. These parameters are **scheduled for removal in version 9.0.0**, after which enabling them will no longer be an option.

The following endpoints are among those affected:

| Endpoint | `query` parameter | `fields` parameter |
| --- | --- | --- |
| [settings.public](https://developer.rocket.chat/apidocs/get-public-settings) | **✓** | **✓** |
| [statistics.list](https://developer.rocket.chat/apidocs/get-statistics-list) | **✓** | **✓** |
| [custom-sounds.list](https://developer.rocket.chat/apidocs/list-custom-sounds) | **✓** | **✓** |
| [emoji-custom.list](https://developer.rocket.chat/apidocs/get-updated-list-of-custom-emojis) | **✓** | **x** |
| [integrations.history](https://developer.rocket.chat/apidocs/get-integration-history) | **✓** | **✓** |
| [integrations.list](https://developer.rocket.chat/apidocs/get-list-of-integrations) | **✓** | **✓** |
| [users.list](https://developer.rocket.chat/apidocs/get-users-list) | **✓** | **✓** |
| [users.info](https://developer.rocket.chat/apidocs/get-users-info) | **x** | **✓** |
| [chat.getThreadsList](https://developer.rocket.chat/apidocs/list-threads) | **✓** | **✓** |
| [chat.getThreadMessages](https://developer.rocket.chat/apidocs/get-thread-messages) | **✓** | **✓** |
| [im.files](https://developer.rocket.chat/apidocs/get-dm-files) | **✓** | **✓** |
| [im.list.everyone](https://developer.rocket.chat/apidocs/list-all-dms) | **✓** | **✓** |
| [im.messages](https://developer.rocket.chat/apidocs/list-dm-messages) | **✓** | **✓** |
| [im.messages.others](https://developer.rocket.chat/apidocs/message-others) | **✓** | **✓** |
| [email-inbox.list](https://developer.rocket.chat/apidocs/list-email-inbox) | **✓** | **✓** |
| [spotlight](https://developer.rocket.chat/apidocs/spotlight) | **✓** | **x** |
| [omnichannel/agents/available](https://developer.rocket.chat/apidocs/get-available-agent-information) | **✓** | **x** |
| [livechat/rooms (GET)](https://developer.rocket.chat/apidocs/get-list-of-livechat-rooms) | **x** | **✓** |
| [canned-responses (GET)](https://developer.rocket.chat/apidocs/list-all-canned-responses) | **x** | **✓** |
| [voip/rooms](https://developer.rocket.chat/apidocs/get-list-of-call-center-rooms) | **x** | **✓** |
| [channels.anonymousread](https://developer.rocket.chat/apidocs/read-channel-messages-anonymously) | **✓** | **✓** |
| [channels.files](https://developer.rocket.chat/apidocs/get-channel-files) | **✓** | **✓** |
| [channels.list.joined](https://developer.rocket.chat/apidocs/get-list-of-joined-channels) | **✓** | **✓** |
| [channels.list](https://developer.rocket.chat/apidocs/get-channel-list) | **✓** | **✓** |
| [channels.messages](https://developer.rocket.chat/apidocs/get-channel-messages) | **✓** | **x** |
| [channels.getIntegrations](https://developer.rocket.chat/apidocs/get-channel-integrations) | **✓** | **✓** |
| [rooms.getDiscussions](https://developer.rocket.chat/apidocs/get-room-discussions) | **✓** | **✓** |
| [teams.list](https://developer.rocket.chat/apidocs/get-list-of-teams) | **✓** | **x** |
| [groups.online](https://developer.rocket.chat/apidocs/get-group-online-users) | **✓** | **x** |
| [groups.getIntegrations](https://developer.rocket.chat/apidocs/get-group-integrations) | **✓** | **✓** |
| [groups.listAll](https://developer.rocket.chat/apidocs/get-list-of-user-groups) | **✓** | **✓** |
| [groups.messages](https://developer.rocket.chat/apidocs/get-group-messages) | **✓** | **✓** |
| [groups.files](https://developer.rocket.chat/apidocs/get-group-files) | **✓** | **✓** |
| [channels.online](https://developer.rocket.chat/apidocs/list-online-users-in-a-channel) | **✓** | **x** |
| [directory](https://developer.rocket.chat/apidocs/directory-1) | **✓** | **✓** |
| [rooms.info](https://developer.rocket.chat/apidocs/get-room-information) | **x** | **✓** |
| [dm.messages](https://developer.rocket.chat/apidocs/list-dm-messages) | **✓** | **✓** |
| [custom-user-status.list](https://developer.rocket.chat/apidocs/list-custom-user-status) | **✓** | **x** |