To be notified when status and other profile fields change, subscribe to user_change events in the Events API or use the RTM API to stream and monitor. When 0 or omitted, the status does not expire. When it becomes this time, the status will be reset.

status_expiration - an integer specifying seconds since the epoch, more commonly known as 'UNIX time'.When clearing the attribute, a default emoji (currently 💬 / :speech_balloon:) will be selected for the user. status_emoji - a string corresponding to an emoji installed on the workspace.status_text - a string of no more than 100 characters does not support markup or other formatting, like user mentions.More directly retrieve status for a specific user with with the users.profile:read scope.Ī user's custom status is represented by the status_text, status_emoji, and status_expiration profile attributes. Both methods require the users:read OAuth scope. You'll find profiles attached to user objects returned by users.list and. Reading statusesĭetermine a user's currently set custom status by consulting their profile. At this time, bot users do not have a user profile and do not have a status.Īdmins on paid teams may also set a user's status by passing the user parameter to the method. Slack is where workplay happens.Ĭustom status is part of a user's profile and setting status requires the users.profile:write scope. We encourage developers to embrace all the ways users and workspaces enjoy utilizing custom status. Some users want to fly the freak flag and use this space to wax poetic while others won't touch the stuff, or only in the most perfunctory way. Users can declare their status by selecting a custom emoji icon and string of text to represent their 'current status' - maybe they're in another office, on the good old telephone, sailing, vacationing in the sticks, or possibly eaten by a grue. They can also set their own custom status, informing their workspace not only that they are at lunch, but exactly what they are eating. Slack users can toggle whether they are marked active or away.

Icons for slack