Actions168
- Bot Actions
- Call & Meeting Actions
- Channel Actions
- Add Bot to Channel
- Add Channel Members
- Approve Channel
- Archive Channel
- Change Channel Member Role
- Change Channel Permission
- Create Channel
- Delete Channel
- Get Channel
- Get Channel Members
- Join Channel
- Leave Channel
- List Channels
- Reject Channel
- Remove Bot From Channel
- Remove Channel Members
- Remove Single Channel Member
- Unarchive Channel
- Update Channel
- Chat Actions
- Cliq Database Actions
- Custom Domain Actions
- Custom Email Actions
- Department Actions
- Designation Actions
- Event Actions
- File Actions
- Maintenance (Bulk Export) Actions
- Message Actions
- Message Component Builder Actions
- OAuth Helper Actions
- Reaction Actions
- Reminder Actions
- Remote Work Actions
- Role Actions
- Team Actions
- Thread Actions
- User Actions
- User Field Actions
- User Status Actions
- Widget Map Ticker Actions
User Status → Add a Transient Status
AI-generatedSummary
Create a transient (temporary) user status for the authenticated OAuth user in Zoho Cliq, specifying presence code, custom message, and expiry time.
Inputs
- Enable AI Error Mode — Whether to return errors as output items instead of stopping execution, useful for recovering from API errors during AI tool runs.
- Input Mode (required) — Choose between 'Using Fields Below' for structured input or 'Using JSON' to provide a raw JSON body matching the API for the transient status.
- Code (required) — Presence code for the transient status: 'available' (online), 'busy' (do not disturb), or 'invisible' (hidden presence). Required when Input Mode is 'structured'.
- Message (required) — Custom transient status text shown in Zoho Cliq, mapping to the API field 'message'. Required when Input Mode is 'structured'.
- Expiry (required) — DateTime when the transient status expires; supports ISO date-time, Unix milliseconds, or expressions resolving to Unix milliseconds. Required when Input Mode is 'structured'.
- Transient Status Definition (JSON) (required) — Raw JSON object for the transient status containing at least 'code', 'message', and 'expiry' fields. Required when Input Mode is 'raw'.
- Include Enhanced Output — Whether to return workflow-friendly success metadata; if disabled, returns Zoho Cliq's standard success response.
Output shape
a single object representing the success response from the API, optionally enhanced with workflow-friendly metadata depending on input setting.
Requires OAuth scope ZohoCliq.Profile.UPDATE and affects only the authenticated OAuth user's transient status. The operation sets one transient status with specified presence code, message, and expiry. Errors can be returned as output items if AI Error Mode is enabled.
Examples
Example 1: Add an available transient status 'Out for lunch' expiring at a specified date-time.
Input Mode: Structured; Code: available; Message: 'Out for lunch'; Expiry: date-time value; Include Enhanced Output: true.