---
title: "Set User Presence (Realtime)"
slug: "set-user-presence-realtime"
tags: ["Deprecated"]
updated: 2026-10-29T14:29:38Z
published: 2026-10-29T14:29:38Z
canonical: "developer.rocket.chat/set-user-presence-realtime"
---

> ## 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.

# Set User Presence (Realtime)

![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Deprecated.svg?sv=2026-02-06&spr=https&st=2026-11-03T09%3A43%3A04Z&se=2026-11-03T10%3A43%3A04Z&sr=c&sp=r&sig=bF2epP43QVpUqKTfupWFTrx9YawwzUwf1h1hdnnX7NA%3D)

Set the user presence status. By default, there are four different statuses available in your workspace:

- `online`
- `busy`
- `away`
- `offline`

To change a user's default status, use [Set User Status](/apidocs/set-user-status) in the REST API. The `UserPresence:setDefaultStatus` method was removed in Rocket.Chat 9.0.0.

## Set temporary user presence status

To set a temporary status, send a request to `UserPresence:{status}` with empty parameters. It only accepts either of these two status options: `away` and `online`. It is particularly useful when the client detects that the user is currently not actively using the application (thus "away") and when the user returns, indicating they are "online" again.

| Method | Requires Auth |
| --- | --- |
| `UserPresence:away` | Yes |
| `UserPresence:online` | Yes |

### Example call

```json
{
    "msg": "method",
    "method": "UserPresence:away",
    "id": "47",
    "params":[]
}
```

### Example response

```json
{
    "msg": "result",
    "id": "47",
    "result": true
}
```