Skip to main content

Nextcloud — User Status

Get and set the user's availability and custom status message.

Integration IDnextcloud-status
AuthNC session
Required NC appuser_status (built-in)
Sourceserver/integrations/nextcloudStatusTools.js

Tools

ToolPurpose
nextcloud_status_getGet the user's current status.
nextcloud_status_setSet status type + custom message + emoji.
nextcloud_status_clearClear the custom message.
nextcloud_status_set_predefinedSet a predefined status (vacationing, commuting, etc.).

Status types

TypeVisible as
onlineGreen dot
awayYellow dot
dndRed dot, suppresses notifications
invisibleGrey dot
offlineGrey, no presence

Endpoints

GET /ocs/v2.php/apps/user_status/api/v1/user_status
PUT /ocs/v2.php/apps/user_status/api/v1/user_status/status
PUT /ocs/v2.php/apps/user_status/api/v1/user_status/message/custom
DELETE /ocs/v2.php/apps/user_status/api/v1/user_status/message

Use cases

  • "Set my status to DND with the message 'Heads down on Q3 reporting' for 2 hours."
  • "Clear my status."
  • (Automation) "When my calendar shows 'Lunch', set status to away with 🍝."

Caveats

Auto-status (e.g. NC's built-in "in a meeting" detection) may overwrite manual statuses. Bee Flow doesn't fight this — set yours explicitly to override.