Zoho Cliq icon

Zoho Cliq

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

Actions168

User Field → Retrieve a Particular User Field

AI-generated

Summary

Retrieve a user field schema definition from Zoho Cliq by specifying its unique field ID, returning either a simplified or raw representation of the field metadata.

Inputs

  • fieldId (required) — The user-field schema definition ID (field metadata/configuration ID) to retrieve. Not a user ID; must be a valid field definition identifier.
  • enableAiErrorMode — Optionally enable AI error mode to return errors as output items instead of stopping execution, useful for workflows involving AI tools.
  • simplify — Choose whether to simplify the response data for easier consumption in workflows.
  • simplifyMode — Specify the mode of simplification: full simplified, raw, or selected specific fields.
  • simplifyFields — Select which fields to include when using the 'selectedFields' simplify mode, always including the record ID.

Output shape

a single user-field schema definition object

The output contains metadata/configuration of the user field for the specified field ID. If simplification is enabled, the response is unwrapped and fields filtered according to simplify mode settings. Errors may be returned as output items if AI error mode is enabled. Requires scope ZohoCliq.Users.READ.

Examples

Example 1: Retrieve metadata of a user field by field ID with simplified output including only the ID and name.

Set 'fieldId' to the desired user field identifier, enable 'simplify', set 'simplifyMode' to 'selectedFields', and choose 'ID' and 'Name' for 'simplifyFields'.

Links

Discussion