Zoho Cliq icon

Zoho Cliq

Fully manage your Zoho Cliq workspace: messages, channels, teams, users, databases, events, reminders, bots, files, and more

Actions168

Role → Update Role Permissions

AI-generated

Summary

Update permissions for a specified Zoho Cliq role by sending a JSON payload with permission changes, optionally batching large updates to handle payload size limits.

Inputs

  • Role (required) — The unique role ID for which to update the permissions. Can be selected from a list or provided manually by ID.
  • Permissions Updates (JSON) (required) — A JSON object specifying the permissions changes to apply, expected in the format: {"list":[{"module":"...","action":"...","status":"...","configs":[...]}]}.
  • Enable Batch Updates — Toggle to split large permissions lists into multiple batched update requests to avoid exceeding payload size limits.
  • Batch Size — Defines the number of permission entries to include per batch request when batch updates are enabled (1-200, default 50).
  • Wait Between Batches (Milliseconds) — Delay between batch requests in milliseconds when batch updates are enabled (default 300ms).
  • Enable AI Error Mode — Whether to continue execution and return errors as output items instead of stopping on failure; useful for workflows involving AI tools.
  • Enable Enhanced Output — Whether to return workflow-friendly output metadata including the API payload and endpoint details.

Output shape

a list of JSON objects representing the API responses for the role permission update(s). Each item corresponds to the result of applying the specified permissions update (batched or single).

Supports batch updating: if enabled, the large permissions update list is split into smaller requests according to the batch size and wait time settings. Errors can optionally be handled in 'AI Error Mode' to continue workflow execution with error details. Output includes enhanced metadata when enabled. Requires the scope ZohoCliq.Organisation.UPDATE for API permission.

Links

Discussion