Website
Community
User Documentation
Free Trial
Search…
Rocket.Chat Developer
Quick Start
Choosing a Deployment Host
Setting up your Development Environment
Rocket.Chat
Rocket Chat Environment Setup
Repository Structure
Deeplink
Two Factor Authentication
Embedded Layout
White Labelling Rocket.Chat
Iframe Integration
Contribute to Rocket.Chat
Mobile App
Mobile App Environment Setup
Testing your Mobile App
Mobile App White Labelling
Mobile App FAQs
Desktop App
Desktop App Environment Setup
Developing your Desktop App
Debugging your Desktop App
Desktop App White Labelling
Omnichannel
Omnichannel Environment Setup
Developing Omnichannel Apps
Livechat Widget Development and Customization
Omnichannel FAQs
Apps Engine
Rocket.Chat App
Rocket.Chat Apps Engine
Getting Started
Adding Features
Testing your App
Sample App Snippets
Slack Compatibility
App Submission to the Marketplace
Apps-Engine API Reference
Bots
Bots Development Environment Setup
Bots Architecture
Creating Your Own Bot From Scratch
Bots FAQs
Reference
Database Schema
API
Deprecation
Schema Definition
Schema Definition v2 (Draft)
Realtime API
REST API
Endpoints
Omnichannel
Team Collaboration Endpoints
Assets Endpoints
Auto Translate Endpoints
Banners Endpoints
Channels Endpoints
Chat Endpoints
Cloud Endpoints
Commands Endpoints
Custom Sounds Endpoints
Custom User Status Endpoints
Custom User Status List
Create custom user status
Delete custom user status
Update custom user status type
DNS Endpoints
E2E Endpoints
Email Inbox Endpoints
Custom Emoji Endpoints
Groups Endpoints
IM Endpoints
Import Endpoints
Instances Endpoints
Integration Endpoints
Invite Endpoints
Miscellaneous Endpoints
OAuthApps Endpoints
Permissions Endpoints
Push Token Endpoints
Roles Endpoints
Rooms Endpoints
Settings Endpoints
Stats Endpoints
Subscriptions Endpoints
Teams Endpoints
Users Endpoints
Video Conference Endpoints
Webdav Endpoint
Other Important Endpoints
Apps Endpoints
Avatars
Livechat Widget API
Fuselage
Contributing
Powered By
GitBook
Update custom user status type
Updates a custom user status
URL
Requires Auth
HTTP Method
api/v1/custom-user-status.update
YES
POST
Headers
Argument
Example
Required
Description
X-User-Id
myuser-name
Required
Your username hash (returned after you log in through the API)
X-Auth-Token
myauth-token
Required
Your token (returned after you log in through the API)
Example Call
1
curl
--location --request POST
'http://localhost:3000/api/v1/custom-user-status.update\
2
--header 'X-Auth-Token: myauth-token
' \
3
--header 'X-User-Id: myuser-name'
4
-d
"_id=SeZHHb77QXWRbnDhn&name=Férias&statusType=busy"
Copied!
Result
Success
1
{
2
"customUserStatus"
:
{
3
"_id"
:
"SeZHHb77QXWRbnDhn"
,
4
"name"
:
"Férias"
,
5
"statusType"
:
"busy"
,
6
"_updatedAt"
:
"2021-09-26T15:23:46.325Z"
7
},
8
"success"
:
true
9
}
Copied!
Errors
Any of the following errors can occur upon the endpoint.
Authorization
: Requires an authentication token for the request to be made.
No custom user status id
: Requires a valid custom user status
_id
Authorization
No custom user stauts id found
1
{
2
"success"
:
false
,
3
"error"
:
"unauthorized"
4
}
Copied!
​
1
{
2
"success"
:
false
,
3
"error"
:
"No custom user status found with the id of \"SeZHHb77QXWRbnDh\"."
4
}
Copied!
​
Previous
Delete custom user status
Next
DNS Endpoints
Last modified
7mo ago
Export as PDF
Copy link
Edit on GitHub
Contents
Headers
Example Call
Result
Success
Errors