Skip to content

Zoho: Get module metadata by API name

Zoho modules.getModuleByApiName: arguments, response, policy and SDK examples.

← Modules operations · Get started

Operation zoho.getmodulebyapiname

Provider route: GET /crm/v8/settings/modules/{moduleIdentifier}. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/zoho with npm, or alter-sdk-zoho with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { ZohoIntegration } from "@alter-ai/zoho";
async function execute(input: Parameters<ZohoIntegration["modules"]["getModuleByApiName"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new ZohoIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.modules.getModuleByApiName(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_zoho import ZohoIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = ZohoIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.modules.get_module_by_api_name(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
pathModelRequired within parentExpand Get module metadata by API name — request body — path
queryobjectOptionalAdditional keys: not allowed
query.fieldsarrayOptionalMaximum items: 100
query.fields[]stringEach itemSpecifies the properties to include in the response
Maximum length: 255
query.include_inner_detailsstringOptionalMaximum length: 512

Referenced models: Get module metadata by API name — request body — path

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$JSONRoot
$ (anyOf 1)objectAlternativeComplete configuration metadata for a single CRM module, including its fields, layouts, profiles, related lists, and supported capabilities
Additional keys: not allowed
$ (anyOf 1).modulesarrayRequired within parentArray of module metadata objects returned for the specified API name. Contains at most one element, as each API name maps to a single module.
Maximum items: 1
$ (anyOf 1).modules[]objectEach itemComplete metadata for a CRM module including configuration, capabilities, fields, layouts, profiles, and related lists.
Additional keys: not allowed
$ (anyOf 1).modules[].$field_statesJSONOptional
$ (anyOf 1).modules[].$field_states (anyOf 1)arrayAlternativeNullable array of field-state identifiers (up to 1 entry, max 20 characters each) that govern dynamic field visibility and validation rules within this module.
Maximum items: 1
$ (anyOf 1).modules[].$field_states (anyOf 1)[]stringEach itemField state identifier
Maximum length: 20
$ (anyOf 1).modules[].$field_states (anyOf 2)nullAlternativeNullable array of field-state identifiers (up to 1 entry, max 20 characters each) that govern dynamic field visibility and validation rules within this module.
Maximum items: 1
$ (anyOf 1).modules[].$field_states (anyOf 2)[]stringEach itemField state identifier
Maximum length: 20
$ (anyOf 1).modules[].$on_demand_propertiesJSONOptional
$ (anyOf 1).modules[].$on_demand_properties (anyOf 1)arrayAlternativeNullable array of string identifiers (up to 100, max 50 chars each) for module properties that are loaded on-demand rather than included in the default response.
Maximum items: 100
$ (anyOf 1).modules[].$on_demand_properties (anyOf 1)[]stringEach itemName of an on-demand property that can be requested explicitly.
Maximum length: 50
$ (anyOf 1).modules[].$on_demand_properties (anyOf 2)nullAlternativeNullable array of string identifiers (up to 100, max 50 chars each) for module properties that are loaded on-demand rather than included in the default response.
Maximum items: 100
$ (anyOf 1).modules[].$on_demand_properties (anyOf 2)[]stringEach itemName of an on-demand property that can be requested explicitly.
Maximum length: 50
$ (anyOf 1).modules[].$others_awaitingbooleanOptionalTrue when other users are awaiting action on records in this module. Exposed only for the Approvals module.
$ (anyOf 1).modules[].$propertiesJSONOptional
$ (anyOf 1).modules[].$properties (anyOf 1)arrayAlternativeNullable array of extended property objects (up to 50) representing additional module capabilities; each item is either a string property name or an object with arbitrary key-value pairs.
Maximum items: 50
$ (anyOf 1).modules[].$properties (anyOf 1)[]JSONEach itemRepresents a module capability or property flag name.
$ (anyOf 1).modules[].$properties (anyOf 1)[] (anyOf 1)stringAlternativeProperty name identifier
Maximum length: 50
$ (anyOf 1).modules[].$properties (anyOf 1)[] (anyOf 2)objectAlternativeExtended property object containing additional module metadata
Additional keys: allowed
$ (anyOf 1).modules[].$properties (anyOf 2)nullAlternativeNullable array of extended property objects (up to 50) representing additional module capabilities; each item is either a string property name or an object with arbitrary key-value pairs.
Maximum items: 50
$ (anyOf 1).modules[].$properties (anyOf 2)[]JSONEach itemRepresents a module capability or property flag name.
$ (anyOf 1).modules[].$properties (anyOf 2)[] (anyOf 1)stringAlternativeProperty name identifier
Maximum length: 50
$ (anyOf 1).modules[].$properties (anyOf 2)[] (anyOf 2)objectAlternativeExtended property object containing additional module metadata
Additional keys: allowed
$ (anyOf 1).modules[].access_typestringOptionalAccess control scope for the module. Possible values: org_based - organization-wide access; team_based - team-specific access. Immutable after module creation; cannot be changed via PUT.
Known values: org_based, team_based
$ (anyOf 1).modules[].activity_badgestringOptionalActivity badge status for the module. Possible values: Enabled - badge is active; Not_Supported - module does not support activity badges; Disabled - badge is inactive.
Known values: Enabled, Not_Supported, Disabled
$ (anyOf 1).modules[].actual_plural_labelstringOptionalSystem-level plural label for the module as stored in the database, representing the untranslated base value. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].actual_singular_labelstringOptionalSystem-level singular label for the module as stored in the database, representing the untranslated base value. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].api_namestringOptionalCase-sensitive API name used to reference this module in API requests (e.g., ‘Leads’, ‘Contacts’, ‘CustomModule1’).
Maximum length: 50
$ (anyOf 1).modules[].api_supportedbooleanOptionalTrue when the module is accessible via the Zoho CRM API; false for modules that are not externally queryable through API endpoints.
$ (anyOf 1).modules[].argumentsarrayOptionalArray of argument objects (up to 10) used to substitute dynamic parameters in web tab URLs (e.g., https://…&id=${Users.User Id}&name=${Users.First Name}). Duplicates are allowed and order is preserved for multi-occurrence parameters; empty for non-web-tab modules.
Maximum items: 10
Unique items: false
$ (anyOf 1).modules[].arguments[]objectEach itemArgument object containing name-value pair for URL parameter substitution
Additional keys: not allowed
$ (anyOf 1).modules[].arguments[].namestringRequired within parentKey name of the URL argument used as a placeholder in the web tab URL template. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].arguments[].valuestringRequired within parentField substitution reference expression resolving to a CRM field value at runtime (e.g., users.recordId). Maximum 100 characters.
Maximum length: 100
$ (anyOf 1).modules[].business_card_field_limitJSONOptional
$ (anyOf 1).modules[].business_card_field_limit (anyOf 1)integerAlternativeMaximum number of fields allowed in the business card view for this module. Non-negative integer; 0 means no fields are configured.
Format: int32
Minimum: 0
$ (anyOf 1).modules[].business_card_field_limit (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).modules[].business_card_fieldsarrayOptionalFields displayed in the business card view (up to 15). Present only when ‘business_card_fields’ is included in the include parameter. Can be empty array, array of objects with api_name and id, or array of string API names.
Maximum items: 15
$ (anyOf 1).modules[].business_card_fields[]JSONEach itemRepresents a field reference in the business card view.
$ (anyOf 1).modules[].business_card_fields[] (anyOf 1)objectAlternativeField reference with API name and unique identifier
Additional keys: not allowed
$ (anyOf 1).modules[].business_card_fields[] (anyOf 1).api_namestringRequired within parentAPI name of the field
Maximum length: 50
$ (anyOf 1).modules[].business_card_fields[] (anyOf 1).idstringRequired within parentUnique identifier of the field
Format: int64
$ (anyOf 1).modules[].business_card_fields[] (anyOf 2)stringAlternativeField API name
Maximum length: 50
$ (anyOf 1).modules[].cc_enabledbooleanOptionalTrue when CommandCenter (workflow orchestration) is enabled for this module; false when not configured or unsupported.
$ (anyOf 1).modules[].chart_viewbooleanOptionalTrue when chart view is currently enabled for this module. Distinct from chart_view_supported, which reflects capability.
$ (anyOf 1).modules[].chart_view_supportedbooleanOptionalTrue when the module’s data structure supports chart visualization. A false value means chart view cannot be enabled regardless of settings.
$ (anyOf 1).modules[].convertablebooleanOptionalTrue when records in this module can be converted to records in another module (e.g., Leads to Contacts/Accounts).
$ (anyOf 1).modules[].creatablebooleanOptionalTrue when new records can be created in this module; false for read-only modules such as analytics or configuration entities.
$ (anyOf 1).modules[].custom_viewJSONOptional
$ (anyOf 1).modules[].custom_view (anyOf 1)objectAlternativeDefault custom view configuration for the module, including filter criteria, display fields, sort settings, and sharing options. Exposed only when ‘custom_view’ is included in the include parameter.
Additional keys: not allowed
$ (anyOf 1).modules[].custom_view (anyOf 1).$modified_criteriabooleanOptionalTrue when the filter criteria of this custom view have been modified from their original configuration.
$ (anyOf 1).modules[].custom_view (anyOf 1).access_typestringRequired within parentAccess scope for the custom view, determining visibility to other users (e.g., private, shared with all, shared with roles).
Known values: shared, public, only_to_me
$ (anyOf 1).modules[].custom_view (anyOf 1).categorystringRequired within parentInteger code representing the sharing category of the custom view (e.g., private, shared_with_everyone, shared_with_roles).
Known values: created_by_me, shared_with_me, public_views
$ (anyOf 1).modules[].custom_view (anyOf 1).created_byJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 1).created_by (anyOf 1)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views created by id, name — shared_created-by_eeb47d537d32
$ (anyOf 1).modules[].custom_view (anyOf 1).created_by (anyOf 2)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views created by id, name — shared_created-by_0a006039d025
$ (anyOf 1).modules[].custom_view (anyOf 1).created_timeJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 1).created_time (anyOf 1)stringAlternativeISO 8601 datetime when the custom view was created, including timezone offset (e.g., 2025-11-20T14:30:00+05:30). Null for system views.
Format: date-time
$ (anyOf 1).modules[].custom_view (anyOf 1).created_time (anyOf 2)nullAlternativeISO 8601 datetime when the custom view was created, including timezone offset (e.g., 2025-11-20T14:30:00+05:30). Null for system views.
Format: date-time
$ (anyOf 1).modules[].custom_view (anyOf 1).criteriaJSONRequired within parentRepresents the filter criteria applied to this Custom View.
$ (anyOf 1).modules[].custom_view (anyOf 1).criteria (anyOf 1)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views criteria comparator, field, type, value
$ (anyOf 1).modules[].custom_view (anyOf 1).criteria (anyOf 2)nullAlternativeNo filter criteria applied.
$ (anyOf 1).modules[].custom_view (anyOf 1).cross_filtersarrayOptionalArray of cross-module filter objects enabling advanced filtering based on related module conditions (e.g., filter Contacts by associated Deals criteria).
Maximum items: 3
Minimum items: 1
$ (anyOf 1).modules[].custom_view (anyOf 1).cross_filters[]objectEach itemCross-filter criterion object defining filtering logic for related modules.
Additional keys: allowed
$ (anyOf 1).modules[].custom_view (anyOf 1).defaultbooleanRequired within parentTrue when this custom view is the default view loaded for the module; only one view per module can be the default.
$ (anyOf 1).modules[].custom_view (anyOf 1).display_valuestringRequired within parentHuman-readable label for the custom view as displayed in the CRM UI. Maximum 100 characters.
Maximum length: 100
$ (anyOf 1).modules[].custom_view (anyOf 1).favoriteJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 1).favorite (anyOf 1)JSONAlternative
$ (anyOf 1).modules[].custom_view (anyOf 1).favorite (anyOf 1) (anyOf 1)integerAlternativeNumeric ranking position of this view in the user’s favorites list. Null when the view has not been marked as a favorite.
Format: int32
$ (anyOf 1).modules[].custom_view (anyOf 1).favorite (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).modules[].custom_view (anyOf 1).favorite (anyOf 2)nullAlternativeNumeric ranking position of this view in the user’s favorites list. Null when the view has not been marked as a favorite.
Format: int32
$ (anyOf 1).modules[].custom_view (anyOf 1).fieldsarrayRequired within parentOrdered list of field objects to display as columns in this custom view, each identified by api_name and id.
Maximum items: 1000
$ (anyOf 1).modules[].custom_view (anyOf 1).fields[]ModelEach itemExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views fields item
$ (anyOf 1).modules[].custom_view (anyOf 1).idstringRequired within parentUnique numeric identifier (as string) for this custom view.
Format: int64
$ (anyOf 1).modules[].custom_view (anyOf 1).last_accessed_timeJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 1).last_accessed_time (anyOf 1)stringAlternativeISO 8601 datetime when this view was last accessed, including timezone offset. Null if never accessed after creation.
Format: date-time
$ (anyOf 1).modules[].custom_view (anyOf 1).last_accessed_time (anyOf 2)nullAlternativeISO 8601 datetime when this view was last accessed, including timezone offset. Null if never accessed after creation.
Format: date-time
$ (anyOf 1).modules[].custom_view (anyOf 1).lockedJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 1).locked (anyOf 1)booleanAlternativeTrue when the view is locked by an administrator; locked views cannot be modified or deleted by regular users.
Default: false
$ (anyOf 1).modules[].custom_view (anyOf 1).locked (anyOf 2)nullAlternativeTrue when the view is locked by an administrator; locked views cannot be modified or deleted by regular users.
Default: false
$ (anyOf 1).modules[].custom_view (anyOf 1).modified_byJSONRequired within parentRepresents the user who last modified this Custom View.
$ (anyOf 1).modules[].custom_view (anyOf 1).modified_by (anyOf 1)objectAlternativeUser who last modified this custom view. Null for system views that have never been modified.
Additional keys: not allowed
$ (anyOf 1).modules[].custom_view (anyOf 1).modified_by (anyOf 1).idstringRequired within parentUnique identifier of the user who modified the custom view.
Format: int64
$ (anyOf 1).modules[].custom_view (anyOf 1).modified_by (anyOf 1).namestringRequired within parentName of the user who modified the custom view.
Maximum length: 101
$ (anyOf 1).modules[].custom_view (anyOf 1).modified_by (anyOf 2)nullAlternativeIndicates that has never been modified.
$ (anyOf 1).modules[].custom_view (anyOf 1).modified_timeJSONRequired within parentRepresents the timestamp when this Custom View was last modified, in ISO 8601 format.
$ (anyOf 1).modules[].custom_view (anyOf 1).modified_time (anyOf 1)stringAlternativeTimestamp when layout was last modified in ISO 8601 format with timezone offset. Null if never modified.
Format: date-time
$ (anyOf 1).modules[].custom_view (anyOf 1).modified_time (anyOf 2)nullAlternativeIndicates that has never been modified.
$ (anyOf 1).modules[].custom_view (anyOf 1).moduleModelOptionalExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views module
$ (anyOf 1).modules[].custom_view (anyOf 1).namestringRequired within parentSystem name identifier for the custom view, distinct from display_value. Maximum 50 characters.
Maximum length: 100
$ (anyOf 1).modules[].custom_view (anyOf 1).offlinebooleanOptionalTrue when this view is available for offline access in Zoho CRM mobile applications. Only exposed for crmmobile and routeiq services.
$ (anyOf 1).modules[].custom_view (anyOf 1).shared_toJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 1).shared_to (anyOf 1)arrayAlternativeArray of sharing target objects (users, roles, groups, or territories) with whom this custom view is shared. Null for public or non-shared views.
Maximum items: 100
$ (anyOf 1).modules[].custom_view (anyOf 1).shared_to (anyOf 1)[]JSONEach itemRepresents a sharing entry defining an entity that this Custom View is shared with.
$ (anyOf 1).modules[].custom_view (anyOf 1).shared_to (anyOf 1)[] (anyOf 1)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_47bbdc5a1afb
$ (anyOf 1).modules[].custom_view (anyOf 1).shared_to (anyOf 1)[] (anyOf 2)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_974890dad625
$ (anyOf 1).modules[].custom_view (anyOf 1).shared_to (anyOf 2)nullAlternativeArray of sharing target objects (users, roles, groups, or territories) with whom this custom view is shared. Null for public or non-shared views.
Maximum items: 100
$ (anyOf 1).modules[].custom_view (anyOf 1).shared_to (anyOf 2)[]JSONEach itemRepresents a sharing entry defining an entity that this Custom View is shared with.
$ (anyOf 1).modules[].custom_view (anyOf 1).shared_to (anyOf 2)[] (anyOf 1)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_47bbdc5a1afb
$ (anyOf 1).modules[].custom_view (anyOf 1).shared_to (anyOf 2)[] (anyOf 2)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_974890dad625
$ (anyOf 1).modules[].custom_view (anyOf 1).sort_byJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 1).sort_by (anyOf 1)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views sort by api name, id — shared_sort-by_7f4ade2b2bbe
$ (anyOf 1).modules[].custom_view (anyOf 1).sort_by (anyOf 2)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views sort by api name, id — shared_sort-by_9fe373614add
$ (anyOf 1).modules[].custom_view (anyOf 1).sort_orderJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 1).sort_order (anyOf 1)stringAlternativeSort direction applied to this view. Possible values: asc - ascending order; desc - descending order; null - no sort order is configured.
Known values: asc, desc
$ (anyOf 1).modules[].custom_view (anyOf 1).sort_order (anyOf 2)nullAlternativeSort direction applied to this view. Possible values: asc - ascending order; desc - descending order; null - no sort order is configured.
Known values: asc, desc
$ (anyOf 1).modules[].custom_view (anyOf 1).system_definedbooleanRequired within parentTrue when this custom view was created automatically by the system; false when created by a user.
$ (anyOf 1).modules[].custom_view (anyOf 1).system_nameJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 1).system_name (anyOf 1)stringAlternativeInternal system name for this custom view, stored separately from the user-visible display_value. Nullable; maximum 255 characters.
Maximum length: 255
$ (anyOf 1).modules[].custom_view (anyOf 1).system_name (anyOf 2)nullAlternativeInternal system name for this custom view, stored separately from the user-visible display_value. Nullable; maximum 255 characters.
Maximum length: 255
$ (anyOf 1).modules[].custom_view (anyOf 1).wrap_textbooleanOptionalTrue when text wrapping is enabled for field values displayed in this custom view; false when values are truncated to a single line.
$ (anyOf 1).modules[].custom_view (anyOf 2)nullAlternativeDefault custom view configuration for the module, including filter criteria, display fields, sort settings, and sharing options. Exposed only when ‘custom_view’ is included in the include parameter.
Additional keys: not allowed
$ (anyOf 1).modules[].custom_view (anyOf 2).$modified_criteriabooleanOptionalTrue when the filter criteria of this custom view have been modified from their original configuration.
$ (anyOf 1).modules[].custom_view (anyOf 2).access_typestringRequired within parentAccess scope for the custom view, determining visibility to other users (e.g., private, shared with all, shared with roles).
Known values: shared, public, only_to_me
$ (anyOf 1).modules[].custom_view (anyOf 2).categorystringRequired within parentInteger code representing the sharing category of the custom view (e.g., private, shared_with_everyone, shared_with_roles).
Known values: created_by_me, shared_with_me, public_views
$ (anyOf 1).modules[].custom_view (anyOf 2).created_byJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 2).created_by (anyOf 1)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views created by id, name — shared_created-by_eeb47d537d32
$ (anyOf 1).modules[].custom_view (anyOf 2).created_by (anyOf 2)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views created by id, name — shared_created-by_0a006039d025
$ (anyOf 1).modules[].custom_view (anyOf 2).created_timeJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 2).created_time (anyOf 1)stringAlternativeISO 8601 datetime when the custom view was created, including timezone offset (e.g., 2025-11-20T14:30:00+05:30). Null for system views.
Format: date-time
$ (anyOf 1).modules[].custom_view (anyOf 2).created_time (anyOf 2)nullAlternativeISO 8601 datetime when the custom view was created, including timezone offset (e.g., 2025-11-20T14:30:00+05:30). Null for system views.
Format: date-time
$ (anyOf 1).modules[].custom_view (anyOf 2).criteriaJSONRequired within parentRepresents the filter criteria applied to this Custom View.
$ (anyOf 1).modules[].custom_view (anyOf 2).criteria (anyOf 1)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views criteria comparator, field, type, value
$ (anyOf 1).modules[].custom_view (anyOf 2).criteria (anyOf 2)nullAlternativeNo filter criteria applied.
$ (anyOf 1).modules[].custom_view (anyOf 2).cross_filtersarrayOptionalArray of cross-module filter objects enabling advanced filtering based on related module conditions (e.g., filter Contacts by associated Deals criteria).
Maximum items: 3
Minimum items: 1
$ (anyOf 1).modules[].custom_view (anyOf 2).cross_filters[]objectEach itemCross-filter criterion object defining filtering logic for related modules.
Additional keys: allowed
$ (anyOf 1).modules[].custom_view (anyOf 2).defaultbooleanRequired within parentTrue when this custom view is the default view loaded for the module; only one view per module can be the default.
$ (anyOf 1).modules[].custom_view (anyOf 2).display_valuestringRequired within parentHuman-readable label for the custom view as displayed in the CRM UI. Maximum 100 characters.
Maximum length: 100
$ (anyOf 1).modules[].custom_view (anyOf 2).favoriteJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 2).favorite (anyOf 1)JSONAlternative
$ (anyOf 1).modules[].custom_view (anyOf 2).favorite (anyOf 1) (anyOf 1)integerAlternativeNumeric ranking position of this view in the user’s favorites list. Null when the view has not been marked as a favorite.
Format: int32
$ (anyOf 1).modules[].custom_view (anyOf 2).favorite (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).modules[].custom_view (anyOf 2).favorite (anyOf 2)nullAlternativeNumeric ranking position of this view in the user’s favorites list. Null when the view has not been marked as a favorite.
Format: int32
$ (anyOf 1).modules[].custom_view (anyOf 2).fieldsarrayRequired within parentOrdered list of field objects to display as columns in this custom view, each identified by api_name and id.
Maximum items: 1000
$ (anyOf 1).modules[].custom_view (anyOf 2).fields[]ModelEach itemExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views fields item
$ (anyOf 1).modules[].custom_view (anyOf 2).idstringRequired within parentUnique numeric identifier (as string) for this custom view.
Format: int64
$ (anyOf 1).modules[].custom_view (anyOf 2).last_accessed_timeJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 2).last_accessed_time (anyOf 1)stringAlternativeISO 8601 datetime when this view was last accessed, including timezone offset. Null if never accessed after creation.
Format: date-time
$ (anyOf 1).modules[].custom_view (anyOf 2).last_accessed_time (anyOf 2)nullAlternativeISO 8601 datetime when this view was last accessed, including timezone offset. Null if never accessed after creation.
Format: date-time
$ (anyOf 1).modules[].custom_view (anyOf 2).lockedJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 2).locked (anyOf 1)booleanAlternativeTrue when the view is locked by an administrator; locked views cannot be modified or deleted by regular users.
Default: false
$ (anyOf 1).modules[].custom_view (anyOf 2).locked (anyOf 2)nullAlternativeTrue when the view is locked by an administrator; locked views cannot be modified or deleted by regular users.
Default: false
$ (anyOf 1).modules[].custom_view (anyOf 2).modified_byJSONRequired within parentRepresents the user who last modified this Custom View.
$ (anyOf 1).modules[].custom_view (anyOf 2).modified_by (anyOf 1)objectAlternativeUser who last modified this custom view. Null for system views that have never been modified.
Additional keys: not allowed
$ (anyOf 1).modules[].custom_view (anyOf 2).modified_by (anyOf 1).idstringRequired within parentUnique identifier of the user who modified the custom view.
Format: int64
$ (anyOf 1).modules[].custom_view (anyOf 2).modified_by (anyOf 1).namestringRequired within parentName of the user who modified the custom view.
Maximum length: 101
$ (anyOf 1).modules[].custom_view (anyOf 2).modified_by (anyOf 2)nullAlternativeIndicates that has never been modified.
$ (anyOf 1).modules[].custom_view (anyOf 2).modified_timeJSONRequired within parentRepresents the timestamp when this Custom View was last modified, in ISO 8601 format.
$ (anyOf 1).modules[].custom_view (anyOf 2).modified_time (anyOf 1)stringAlternativeTimestamp when layout was last modified in ISO 8601 format with timezone offset. Null if never modified.
Format: date-time
$ (anyOf 1).modules[].custom_view (anyOf 2).modified_time (anyOf 2)nullAlternativeIndicates that has never been modified.
$ (anyOf 1).modules[].custom_view (anyOf 2).moduleModelOptionalExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views module
$ (anyOf 1).modules[].custom_view (anyOf 2).namestringRequired within parentSystem name identifier for the custom view, distinct from display_value. Maximum 50 characters.
Maximum length: 100
$ (anyOf 1).modules[].custom_view (anyOf 2).offlinebooleanOptionalTrue when this view is available for offline access in Zoho CRM mobile applications. Only exposed for crmmobile and routeiq services.
$ (anyOf 1).modules[].custom_view (anyOf 2).shared_toJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 2).shared_to (anyOf 1)arrayAlternativeArray of sharing target objects (users, roles, groups, or territories) with whom this custom view is shared. Null for public or non-shared views.
Maximum items: 100
$ (anyOf 1).modules[].custom_view (anyOf 2).shared_to (anyOf 1)[]JSONEach itemRepresents a sharing entry defining an entity that this Custom View is shared with.
$ (anyOf 1).modules[].custom_view (anyOf 2).shared_to (anyOf 1)[] (anyOf 1)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_47bbdc5a1afb
$ (anyOf 1).modules[].custom_view (anyOf 2).shared_to (anyOf 1)[] (anyOf 2)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_974890dad625
$ (anyOf 1).modules[].custom_view (anyOf 2).shared_to (anyOf 2)nullAlternativeArray of sharing target objects (users, roles, groups, or territories) with whom this custom view is shared. Null for public or non-shared views.
Maximum items: 100
$ (anyOf 1).modules[].custom_view (anyOf 2).shared_to (anyOf 2)[]JSONEach itemRepresents a sharing entry defining an entity that this Custom View is shared with.
$ (anyOf 1).modules[].custom_view (anyOf 2).shared_to (anyOf 2)[] (anyOf 1)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_47bbdc5a1afb
$ (anyOf 1).modules[].custom_view (anyOf 2).shared_to (anyOf 2)[] (anyOf 2)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_974890dad625
$ (anyOf 1).modules[].custom_view (anyOf 2).sort_byJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 2).sort_by (anyOf 1)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views sort by api name, id — shared_sort-by_7f4ade2b2bbe
$ (anyOf 1).modules[].custom_view (anyOf 2).sort_by (anyOf 2)ModelAlternativeExpand Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views sort by api name, id — shared_sort-by_9fe373614add
$ (anyOf 1).modules[].custom_view (anyOf 2).sort_orderJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 2).sort_order (anyOf 1)stringAlternativeSort direction applied to this view. Possible values: asc - ascending order; desc - descending order; null - no sort order is configured.
Known values: asc, desc
$ (anyOf 1).modules[].custom_view (anyOf 2).sort_order (anyOf 2)nullAlternativeSort direction applied to this view. Possible values: asc - ascending order; desc - descending order; null - no sort order is configured.
Known values: asc, desc
$ (anyOf 1).modules[].custom_view (anyOf 2).system_definedbooleanRequired within parentTrue when this custom view was created automatically by the system; false when created by a user.
$ (anyOf 1).modules[].custom_view (anyOf 2).system_nameJSONRequired within parent
$ (anyOf 1).modules[].custom_view (anyOf 2).system_name (anyOf 1)stringAlternativeInternal system name for this custom view, stored separately from the user-visible display_value. Nullable; maximum 255 characters.
Maximum length: 255
$ (anyOf 1).modules[].custom_view (anyOf 2).system_name (anyOf 2)nullAlternativeInternal system name for this custom view, stored separately from the user-visible display_value. Nullable; maximum 255 characters.
Maximum length: 255
$ (anyOf 1).modules[].custom_view (anyOf 2).wrap_textbooleanOptionalTrue when text wrapping is enabled for field values displayed in this custom view; false when values are truncated to a single line.
$ (anyOf 1).modules[].default_mapping_fieldsarrayOptionalArray of default field mapping objects (up to 25) for data import and integration operations. Exposed only for SALESORDERS, INVOICES, QUOTES, QUOTEDITEMS, ORDEREDITEMS, and INVOICEDITEMS modules; each entry identifies a field by api_name and id.
Maximum items: 25
$ (anyOf 1).modules[].default_mapping_fields[]objectEach itemField mapping configuration for import operations.
Additional keys: not allowed
$ (anyOf 1).modules[].default_mapping_fields[].api_namestringRequired within parentAPI name of the field in the default mapping configuration. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].default_mapping_fields[].idstringRequired within parentUnique numeric identifier (as string) of the field in the default mapping configuration.
Format: int64
$ (anyOf 1).modules[].deletablebooleanOptionalTrue when records in this module can be permanently deleted; false for protected modules such as configuration entities or system-managed records.
$ (anyOf 1).modules[].descriptionJSONOptional
$ (anyOf 1).modules[].description (anyOf 1)stringAlternativeUser-defined description of the module. Null when no description has been set. Maximum 255 characters; empty string should not be used.
Maximum length: 255
$ (anyOf 1).modules[].description (anyOf 2)nullAlternativeUser-defined description of the module. Null when no description has been set. Maximum 255 characters; empty string should not be used.
Maximum length: 255
$ (anyOf 1).modules[].display_fieldJSONOptionalField designation used as the record display name or title in this module. Either a string containing the field’s API name, or an object with api_name and id.
$ (anyOf 1).modules[].display_field (anyOf 1)stringAlternativeAPI name of the display field
Maximum length: 50
$ (anyOf 1).modules[].display_field (anyOf 2)objectAlternativeDisplay field object with detailed properties
Additional keys: not allowed
$ (anyOf 1).modules[].display_field (anyOf 2).api_namestringRequired within parentAPI name of the display field
Maximum length: 50
$ (anyOf 1).modules[].display_field (anyOf 2).idstringRequired within parentUnique identifier of the display field
Format: int64
$ (anyOf 1).modules[].display_field (anyOf 3)nullAlternativeNo display field configured
$ (anyOf 1).modules[].editablebooleanOptionalTrue when existing records in this module can be edited by users with appropriate permissions; false for read-only modules.
$ (anyOf 1).modules[].emailTemplate_supportbooleanOptionalTrue when email templates can be used to send emails from records in this module; false when email template functionality is not supported.
$ (anyOf 1).modules[].email_parser_supportedbooleanOptionalTrue when email parsing is supported for this module, enabling automatic record creation or updates from inbound emails.
$ (anyOf 1).modules[].feeds_requiredbooleanOptionalTrue when activity feeds are enabled for this module, displaying a timeline of record activities and updates.
$ (anyOf 1).modules[].fieldsarrayOptionalArray of complete field metadata objects (up to 1000) for all fields in this module. Populated only when ‘fields’ is included in the include query parameter and when the service is creator.
Maximum items: 1000
$ (anyOf 1).modules[].fields[]objectEach itemField metadata object containing properties, data type, and configuration.
Additional keys: allowed
$ (anyOf 1).modules[].filter_statusbooleanOptionalTrue when custom view filters are currently active for this module; false when no active filter state is set.
$ (anyOf 1).modules[].filter_supportedbooleanOptionalTrue when this module supports custom view filtering; false for modules that do not allow filter configuration.
$ (anyOf 1).modules[].generated_typestringOptionalClassification of how this module was generated. Possible values: default - standard system module; custom - user-created module; web - web tab module; linking - many-to-many linking module; subform - dynamic subform module; static_subform - static subform; field_tracker - field change tracker; picklisttracker - picklist change tracker.
Known values: field_tracker, default, web, linking, custom, picklisttracker, subform, static_subform
$ (anyOf 1).modules[].global_search_supportedbooleanOptionalTrue when records in this module appear in global search results; false when the module is excluded from global search.
$ (anyOf 1).modules[].has_more_profilesbooleanOptionalTrue when the profiles array is truncated and additional profiles exist beyond those returned (pagination indicator); false when the full profile list is included.
$ (anyOf 1).modules[].idstringRequired within parentUnique numeric identifier (as string) for this module. Required field; used as the stable reference across all API operations.
Format: int64
$ (anyOf 1).modules[].inventory_template_supportedbooleanOptionalTrue when inventory templates (e.g., for quotes, invoices) can be configured for this module; false when not supported.
$ (anyOf 1).modules[].isBlueprintSupportedbooleanOptionalTrue when Blueprint process automation can be configured for this module; false when Blueprint is not available for this module type.
$ (anyOf 1).modules[].kanban_viewbooleanOptionalTrue when kanban view is currently enabled for this module. Distinct from kanban_view_supported, which reflects capability regardless of current setting.
$ (anyOf 1).modules[].kanban_view_supportedbooleanOptionalTrue when the module’s data structure supports kanban view. A false value means kanban view cannot be enabled regardless of settings.
$ (anyOf 1).modules[].layoutsarrayOptionalArray of layout configuration objects (up to 7) available for this module, ordered by relevance of profiles and record creation for the current user. Populated only when ‘layouts’ is included in the include query parameter.
Maximum items: 7
$ (anyOf 1).modules[].layouts[]objectEach itemLayout configuration object containing layout metadata, profile associations, and field arrangements.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].actions_allowedobjectOptionalObject enumerating the operations that the current user can perform on this layout, including flags for clone, deactivate, delete, downgrade, edit, rename, and configure permissions.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].actions_allowed.clonebooleanRequired within parentTrue when the current user has permission to clone this layout.
$ (anyOf 1).modules[].layouts[].actions_allowed.deactivatebooleanRequired within parentTrue when the current user has permission to deactivate this layout.
$ (anyOf 1).modules[].layouts[].actions_allowed.deletebooleanRequired within parentTrue when the current user has permission to delete this layout.
$ (anyOf 1).modules[].layouts[].actions_allowed.downgradebooleanRequired within parentTrue when the current user has permission to downgrade this layout to a simpler layout type.
$ (anyOf 1).modules[].layouts[].actions_allowed.editbooleanRequired within parentTrue when the current user has permission to edit the fields and settings of this layout.
$ (anyOf 1).modules[].layouts[].actions_allowed.renamebooleanRequired within parentTrue when the current user has permission to rename this layout.
$ (anyOf 1).modules[].layouts[].actions_allowed.set_layout_permissionsbooleanRequired within parentTrue when the current user has permission to configure profile-based access permissions for this layout.
$ (anyOf 1).modules[].layouts[].api_namestringOptionalAPI name used to reference this layout in API requests. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].convert_mappingobjectOptionalConversion mapping configuration defining target modules (Accounts, Contacts, Deals) and field-level mappings when records in this module are converted. Populated only when ‘convert_mapping’ is included in the include parameter.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].convert_mapping.AccountsobjectOptionalConfiguration object for converting this module’s records to Accounts, including the Account module’s display label, id, and internal name.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].convert_mapping.Accounts.display_labelstringRequired within parentHuman-readable display label for the Accounts module shown in the conversion UI. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].convert_mapping.Accounts.idstringRequired within parentUnique numeric identifier (as string) for the Accounts module used as the conversion target.
Format: int64
$ (anyOf 1).modules[].layouts[].convert_mapping.Accounts.namestringRequired within parentInternal system name of the Accounts module. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].convert_mapping.ContactsobjectOptionalConfiguration object for converting this module’s records to Contacts, including the Contacts module’s display label, id, and internal name.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].convert_mapping.Contacts.display_labelstringRequired within parentHuman-readable display label for the Contacts module shown in the conversion UI. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].convert_mapping.Contacts.idstringRequired within parentUnique numeric identifier (as string) for the Contacts module used as the conversion target.
Format: int64
$ (anyOf 1).modules[].layouts[].convert_mapping.Contacts.namestringRequired within parentInternal system name of the Contacts module. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].convert_mapping.DealsobjectOptionalConfiguration object for converting this module’s records to Deals, including the Deals module’s display label, id, internal name, and an array of field-level mapping configurations.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].convert_mapping.Deals.display_labelstringRequired within parentHuman-readable display label for the Deals module shown in the conversion UI. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].convert_mapping.Deals.fieldsarrayRequired within parentArray of field mapping objects (up to 1000) specifying how source module fields map to Deals fields during conversion; each entry contains the Deals field api_name, display label, id, and whether the field is required.
Maximum items: 1000
$ (anyOf 1).modules[].layouts[].convert_mapping.Deals.fields[]objectEach itemField mapping configuration specifying a single field for conversion.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].convert_mapping.Deals.fields[].api_namestringRequired within parentAPI name of the target Deals field in this mapping. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].layouts[].convert_mapping.Deals.fields[].field_labelstringRequired within parentHuman-readable display label for the Deals field in the conversion UI. Maximum 100 characters.
Maximum length: 100
$ (anyOf 1).modules[].layouts[].convert_mapping.Deals.fields[].idstringRequired within parentUnique numeric identifier (as string) of the Deals field in this mapping.
Format: int64
$ (anyOf 1).modules[].layouts[].convert_mapping.Deals.fields[].requiredbooleanRequired within parentTrue when this Deals field must be populated during the record conversion process; false when it is optional.
$ (anyOf 1).modules[].layouts[].convert_mapping.Deals.idstringRequired within parentUnique numeric identifier (as string) for the Deals module used as the conversion target.
Format: int64
$ (anyOf 1).modules[].layouts[].convert_mapping.Deals.namestringRequired within parentAPI name used internally to identify the Deals module within the conversion mapping. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].convert_mapping.InvoicesobjectOptionalConversion target configuration object for the Invoices module, containing display label and identifier details.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].convert_mapping.Invoices.display_labelstringRequired within parentHuman-readable label displayed for the Invoices module in the conversion mapping. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].convert_mapping.Invoices.idstringRequired within parentUnique numeric identifier (as string) for the Invoices module in the conversion mapping.
Format: int64
$ (anyOf 1).modules[].layouts[].convert_mapping.Invoices.namestringRequired within parentAPI name used internally to identify the Invoices module within the conversion mapping. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].convert_mapping.SalesOrdersobjectOptionalConversion target configuration object for the SalesOrders module, containing display label and identifier details.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].convert_mapping.SalesOrders.display_labelstringRequired within parentHuman-readable label displayed for the SalesOrders module in the conversion mapping. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].convert_mapping.SalesOrders.idstringRequired within parentUnique numeric identifier (as string) for the SalesOrders module in the conversion mapping.
Format: int64
$ (anyOf 1).modules[].layouts[].convert_mapping.SalesOrders.namestringRequired within parentAPI name used internally to identify the SalesOrders module within the conversion mapping. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].created_byJSONOptional
$ (anyOf 1).modules[].layouts[].created_by (anyOf 1)objectAlternativeUser who created this layout, containing id and name. Null when created by the system.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].created_by (anyOf 1).idstringRequired within parentUnique numeric identifier (as string) of the user who created the layout.
Format: int64
$ (anyOf 1).modules[].layouts[].created_by (anyOf 1).namestringRequired within parentFull name of the user who created the layout. Maximum 101 characters.
Maximum length: 101
$ (anyOf 1).modules[].layouts[].created_by (anyOf 2)nullAlternativeUser who created this layout, containing id and name. Null when created by the system.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].created_by (anyOf 2).idstringRequired within parentUnique numeric identifier (as string) of the user who created the layout.
Format: int64
$ (anyOf 1).modules[].layouts[].created_by (anyOf 2).namestringRequired within parentFull name of the user who created the layout. Maximum 101 characters.
Maximum length: 101
$ (anyOf 1).modules[].layouts[].created_forJSONOptional
$ (anyOf 1).modules[].layouts[].created_for (anyOf 1)stringAlternativeIdentifier of the entity (user, profile, or role) for which this layout was created. Maximum 100 characters. Null if created for general use.
Maximum length: 100
$ (anyOf 1).modules[].layouts[].created_for (anyOf 2)nullAlternativeIdentifier of the entity (user, profile, or role) for which this layout was created. Maximum 100 characters. Null if created for general use.
Maximum length: 100
$ (anyOf 1).modules[].layouts[].created_timeJSONOptional
$ (anyOf 1).modules[].layouts[].created_time (anyOf 1)stringAlternativeISO 8601 timestamp with timezone offset recording when the layout was created; nullable.
Format: date-time
$ (anyOf 1).modules[].layouts[].created_time (anyOf 2)nullAlternativeISO 8601 timestamp with timezone offset recording when the layout was created; nullable.
Format: date-time
$ (anyOf 1).modules[].layouts[].display_labelstringRequired within parentHuman-readable label displayed in the UI for this layout. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].generated_typestringRequired within parentClassification of how the layout was generated. Possible values: default - standard system layout; custom - user-created; web - web tab; linking - many-to-many; subform - dynamic subform; static_subform - static subform; orchestration - CommandCenter; field_tracker - field change tracker; webtab_slyteui - Slyte UI web tab; system - core system layout.
Known values: default, web, custom, linking, subform, orchestration, field_tracker, webtab_slyteui, static_subform, system
$ (anyOf 1).modules[].layouts[].has_more_profilesbooleanOptionalTrue when additional profiles beyond the current page are associated with this layout, signaling that further pagination is required.
$ (anyOf 1).modules[].layouts[].idstringRequired within parentUnique numeric identifier (as string) for the layout.
Format: int64
$ (anyOf 1).modules[].layouts[].modified_byJSONOptionalRepresents the user who last modified this layout.
$ (anyOf 1).modules[].layouts[].modified_by (anyOf 1)objectAlternativeUser who last modified this custom view. Null for system views that have never been modified.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].modified_by (anyOf 1).idstringRequired within parentUnique identifier of the user who modified the custom view.
Format: int64
$ (anyOf 1).modules[].layouts[].modified_by (anyOf 1).namestringRequired within parentName of the user who modified the custom view.
Maximum length: 101
$ (anyOf 1).modules[].layouts[].modified_by (anyOf 2)nullAlternativeIndicates that has never been modified.
$ (anyOf 1).modules[].layouts[].modified_timeJSONOptionalRepresents the timestamp when this layout was last modified, in ISO 8601 format.
$ (anyOf 1).modules[].layouts[].modified_time (anyOf 1)stringAlternativeTimestamp when layout was last modified in ISO 8601 format with timezone offset. Null if never modified.
Format: date-time
$ (anyOf 1).modules[].layouts[].modified_time (anyOf 2)nullAlternativeIndicates that has never been modified.
$ (anyOf 1).modules[].layouts[].namestringRequired within parentInternal API name of the layout. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].profilesarrayOptionalArray of user profile objects (up to 202) that have access to this layout, each containing profile id, name, and default view configuration.
Maximum items: 202
$ (anyOf 1).modules[].layouts[].profiles[]objectEach itemProfile configuration with default view settings.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].profiles[]._default_assignment_viewobjectRequired within parentDefault assignment view configuration applied when records are assigned under this profile, controlling how record assignment operations are presented.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].profiles[]._default_assignment_view.idstringRequired within parentUnique numeric identifier (as string) of the default assignment view associated with this profile.
Format: int64
$ (anyOf 1).modules[].layouts[].profiles[]._default_assignment_view.namestringRequired within parentDisplay name of the default assignment view. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].profiles[]._default_assignment_view.typestringRequired within parentCategory of the default assignment view. Possible values: inventory_templates, layout, canvas, wizard.
Known values: inventory_templates, layout, canvas, wizard
$ (anyOf 1).modules[].layouts[].profiles[]._default_viewobjectRequired within parentDefault custom view configuration applied to this profile, determining the initial view presented to users accessing records.
Additional keys: not allowed
$ (anyOf 1).modules[].layouts[].profiles[]._default_view.idstringRequired within parentUnique numeric identifier (as string) of the default view associated with this profile.
Format: int64
$ (anyOf 1).modules[].layouts[].profiles[]._default_view.namestringRequired within parentDisplay name of the default custom view. Maximum 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].layouts[].profiles[]._default_view.typestringRequired within parentCategory of the default custom view. Possible values: inventory_templates, layout, canvas, wizard.
Known values: inventory_templates, layout, canvas, wizard
$ (anyOf 1).modules[].layouts[].profiles[].defaultbooleanRequired within parentTrue when this profile serves as the default profile for the layout.
$ (anyOf 1).modules[].layouts[].profiles[].idstringRequired within parentUnique numeric identifier (as string) for this profile.
Format: int64
$ (anyOf 1).modules[].layouts[].profiles[].namestringRequired within parentName identifying the profile associated with this layout. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].layouts[].sectionsarrayOptionalOrdered list of sections grouping fields within the layout. Maximum 7 sections.
Maximum items: 7
$ (anyOf 1).modules[].layouts[].sections[]objectEach itemSection configuration with fields and display settings.
Additional keys: allowed
$ (anyOf 1).modules[].layouts[].show_business_cardbooleanOptionalTrue when the business card view is enabled for this layout.
$ (anyOf 1).modules[].layouts[].sourcestringRequired within parentSource system that originated the layout configuration. Possible values: crm, platform_plugin, marketplace_plugin, campaign_integration.
Known values: crm, platform_plugin, marketplace_plugin, campaign_integration
$ (anyOf 1).modules[].layouts[].statusstringRequired within parentCurrent lifecycle state of the layout. Possible values: active - in use; inactive - disabled; downgraded - reduced to simpler type; hidden - not visible in UI.
Known values: active, inactive, downgraded, hidden
$ (anyOf 1).modules[].layouts[].visiblebooleanOptionalTrue when the layout is visible and accessible to users.
$ (anyOf 1).modules[].lookup_field_propertiesJSONOptional
$ (anyOf 1).modules[].lookup_field_properties (anyOf 1)objectAlternativeConfiguration properties governing lookup field behavior for this module. Null when the module has no lookup field configuration.
Additional keys: allowed
$ (anyOf 1).modules[].lookup_field_properties (anyOf 2)nullAlternativeConfiguration properties governing lookup field behavior for this module. Null when the module has no lookup field configuration.
Additional keys: allowed
$ (anyOf 1).modules[].lookupablebooleanOptionalTrue when this module can be targeted as a lookup field by other modules.
$ (anyOf 1).modules[].masked_fields_countJSONOptional
$ (anyOf 1).modules[].masked_fields_count (anyOf 1)integerAlternativeCount of masked fields in this module. Exposed only when the ‘fields’ include parameter is specified.
Format: int32
$ (anyOf 1).modules[].masked_fields_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).modules[].modified_byJSONOptionalRepresents the user who last modified this module configuration.
$ (anyOf 1).modules[].modified_by (anyOf 1)objectAlternativeUser who last modified this custom view. Null for system views that have never been modified.
Additional keys: not allowed
$ (anyOf 1).modules[].modified_by (anyOf 1).idstringRequired within parentUnique identifier of the user who modified the custom view.
Format: int64
$ (anyOf 1).modules[].modified_by (anyOf 1).namestringRequired within parentName of the user who modified the custom view.
Maximum length: 101
$ (anyOf 1).modules[].modified_by (anyOf 2)nullAlternativeIndicates that has never been modified.
$ (anyOf 1).modules[].modified_timeJSONOptional
$ (anyOf 1).modules[].modified_time (anyOf 1)stringAlternativeISO 8601 timestamp with timezone offset recording when the module configuration was last modified. Null when the module has never been modified after creation.
Format: date-time
$ (anyOf 1).modules[].modified_time (anyOf 2)nullAlternativeISO 8601 timestamp with timezone offset recording when the module configuration was last modified. Null when the module has never been modified after creation.
Format: date-time
$ (anyOf 1).modules[].module_namestringOptionalSystem-level API name identifying the module, used in API requests and responses. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].module_typestringOptionalCategorizes the module as ENTITIES for standard data modules or CONFIGURATION_ENTITIES for configuration and settings modules.
Known values: CONFIGURATION_ENTITIES, ENTITIES
$ (anyOf 1).modules[].parent_moduleobjectOptionalReference to the parent module for child modules such as subforms and field trackers. Returns an empty object {} for standalone modules. This is populated with api_name and id for modules with parent relationships.
Additional keys: not allowed
$ (anyOf 1).modules[].parent_module.api_namestringOptionalAPI name of the parent module, used to identify it in API calls. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].parent_module.idstringOptionalUnique numeric identifier (as string) of the parent module.
Format: int64
$ (anyOf 1).modules[].per_pageJSONOptional
$ (anyOf 1).modules[].per_page (anyOf 1)integerAlternativeDefault number of records displayed per page when listing data for this module.
Format: int32
$ (anyOf 1).modules[].per_page (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).modules[].plural_labelstringOptionalLocalized plural display label for the module as shown in the UI, reflecting the active language setting. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].presence_sub_menubooleanOptionalTrue when the presence submenu is available for this module.
$ (anyOf 1).modules[].private_profileJSONOptional
$ (anyOf 1).modules[].private_profile (anyOf 1)objectAlternativePrivate profile configuration for team-based access control. Populated only when access_type is ‘team_based’ with profile name and ID; null for org_based modules.
Additional keys: not allowed
$ (anyOf 1).modules[].private_profile (anyOf 1).idstringRequired within parentUnique numeric identifier (as string) of the private profile.
Format: int64
$ (anyOf 1).modules[].private_profile (anyOf 1).namestringRequired within parentDisplay name of the private profile; maximum 101 characters.
Maximum length: 101
$ (anyOf 1).modules[].private_profile (anyOf 2)nullAlternativePrivate profile configuration for team-based access control. Populated only when access_type is ‘team_based’ with profile name and ID; null for org_based modules.
Additional keys: not allowed
$ (anyOf 1).modules[].private_profile (anyOf 2).idstringRequired within parentUnique numeric identifier (as string) of the private profile.
Format: int64
$ (anyOf 1).modules[].private_profile (anyOf 2).namestringRequired within parentDisplay name of the private profile; maximum 101 characters.
Maximum length: 101
$ (anyOf 1).modules[].profile_countJSONOptional
$ (anyOf 1).modules[].profile_count (anyOf 1)integerAlternativeCount of profiles assigned to this module; 0 indicates no profile assignments are configured. Maximum 203 profiles per module.
Format: int32
$ (anyOf 1).modules[].profile_count (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).modules[].profilesarrayOptionalProfiles with access to this module; contains up to 203 entries.
Maximum items: 203
$ (anyOf 1).modules[].profiles[]objectEach itemProfile reference with ID and name
Additional keys: not allowed
$ (anyOf 1).modules[].profiles[].idstringRequired within parentUnique numeric identifier of the profile (as string).
Format: int64
$ (anyOf 1).modules[].profiles[].namestringOptionalDisplay name of the profile; maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].public_fields_configuredbooleanOptionalTrue when public fields have been configured for this module.
$ (anyOf 1).modules[].quick_createbooleanOptionalTrue when quick create functionality is enabled for this module.
$ (anyOf 1).modules[].recycle_bin_on_deletebooleanOptionalTrue when deleted records are moved to the recycle bin instead of being permanently deleted.
$ (anyOf 1).modules[].related_list_propertiesJSONOptional
$ (anyOf 1).modules[].related_list_properties (anyOf 1)objectAlternativeConfiguration and settings for related lists in this module; null when no related-list properties are defined.
Additional keys: allowed
$ (anyOf 1).modules[].related_list_properties (anyOf 2)nullAlternativeConfiguration and settings for related lists in this module; null when no related-list properties are defined.
Additional keys: allowed
$ (anyOf 1).modules[].related_listsarrayOptionalRelated lists (subforms and related modules) displayed in this module’s detail view; populated only when ‘related_lists’ is included in the include query parameter.
Maximum items: 2147483647
$ (anyOf 1).modules[].related_lists[]objectEach itemRelated list configuration defining how related module records are displayed and managed within the parent module’s detail view.
Additional keys: not allowed
$ (anyOf 1).modules[].related_lists[]._layout_specific_propertiesarrayOptionalPer-layout configuration entries governing how this related list appears within each associated layout; contains up to 2,147,483,647 items.
Maximum items: 2147483647
$ (anyOf 1).modules[].related_lists[]._layout_specific_properties[]objectEach itemLayout-specific configuration object containing sequence number and layout reference for a related list in a particular layout
Additional keys: allowed
$ (anyOf 1).modules[].related_lists[]._layout_specific_properties[].layoutobjectRequired within parentLayout reference object identifying the specific layout to which this related list configuration applies.
Additional keys: not allowed
$ (anyOf 1).modules[].related_lists[]._layout_specific_properties[].layout.idstringOptionalUnique numeric identifier (as string) for the layout.
Format: int64
$ (anyOf 1).modules[].related_lists[]._layout_specific_properties[].layout.namestringOptionalDisplay name of the layout, up to 40 characters.
Maximum length: 40
$ (anyOf 1).modules[].related_lists[]._layout_specific_properties[].sequence_numberJSONRequired within parent
$ (anyOf 1).modules[].related_lists[]._layout_specific_properties[].sequence_number (anyOf 1)integerAlternativeNumeric position defining the display order of this related list within its associated layout.
Format: int32
$ (anyOf 1).modules[].related_lists[]._layout_specific_properties[].sequence_number (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).modules[].related_lists[].actionJSONRequired within parent
$ (anyOf 1).modules[].related_lists[].action (anyOf 1)stringAlternativeAction URL or operation identifier associated with this related list, up to 64 characters; null when no action is defined.
Maximum length: 64
$ (anyOf 1).modules[].related_lists[].action (anyOf 2)nullAlternativeAction URL or operation identifier associated with this related list, up to 64 characters; null when no action is defined.
Maximum length: 64
$ (anyOf 1).modules[].related_lists[].api_namestringRequired within parentAPI name used to reference this related list programmatically, up to 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].related_lists[].connectedlookupApiNamestringOptionalAPI name of the connected lookup field linking this related list to another module, up to 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].related_lists[].connectedmoduleJSONOptional
$ (anyOf 1).modules[].related_lists[].connectedmodule (anyOf 1)stringAlternativeAPI name of the connected module for this related list; null when no module connection exists. Between 1 and 250 alphanumeric or underscore characters when present.
Maximum length: 250
Minimum length: 1
Pattern: ^[A-Za-z0-9_]+$
$ (anyOf 1).modules[].related_lists[].connectedmodule (anyOf 2)nullAlternativeAPI name of the connected module for this related list; null when no module connection exists. Between 1 and 250 alphanumeric or underscore characters when present.
Maximum length: 250
Minimum length: 1
Pattern: ^[A-Za-z0-9_]+$
$ (anyOf 1).modules[].related_lists[].customize_display_labelbooleanRequired within parentTrue when the display label for this related list can be customized.
$ (anyOf 1).modules[].related_lists[].customize_fieldsbooleanRequired within parentTrue when fields in this related list can be customized.
$ (anyOf 1).modules[].related_lists[].customize_sortbooleanRequired within parentTrue when sorting for this related list can be customized.
$ (anyOf 1).modules[].related_lists[].display_labelstringRequired within parentUI display label for this related list. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].related_lists[].field_enabledbooleanOptionalTrue when this related list field is enabled and active.
$ (anyOf 1).modules[].related_lists[].fieldsarrayOptionalList of fields displayed in this related list. Maximum 1000 items.
Maximum items: 1000
$ (anyOf 1).modules[].related_lists[].fields[]objectEach itemField reference containing the API name and unique identifier of a field displayed in the related list.
Additional keys: not allowed
$ (anyOf 1).modules[].related_lists[].fields[].api_namestringRequired within parentAPI name of the field used in programmatic access. Maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].related_lists[].fields[].idstringRequired within parentUnique numeric identifier of the field, returned as a string.
Format: int64
$ (anyOf 1).modules[].related_lists[].hrefJSONRequired within parent
$ (anyOf 1).modules[].related_lists[].href (anyOf 1)stringAlternativeReference URL for the related list, or null if not applicable. Between 1 and 2048 characters when present.
Maximum length: 2048
Minimum length: 1
$ (anyOf 1).modules[].related_lists[].href (anyOf 2)nullAlternativeReference URL for the related list, or null if not applicable. Between 1 and 2048 characters when present.
Maximum length: 2048
Minimum length: 1
$ (anyOf 1).modules[].related_lists[].idstringRequired within parentUnique numeric identifier of the related list, returned as a string.
Format: int64
$ (anyOf 1).modules[].related_lists[].linkingmoduleJSONOptional
$ (anyOf 1).modules[].related_lists[].linkingmodule (anyOf 1)stringAlternativeAPI name of the linking module associated with this related list; null when no linking module is configured. Between 1 and 250 alphanumeric or underscore characters when present.
Maximum length: 250
Minimum length: 1
Pattern: ^[A-Za-z0-9_]+$
$ (anyOf 1).modules[].related_lists[].linkingmodule (anyOf 2)nullAlternativeAPI name of the linking module associated with this related list; null when no linking module is configured. Between 1 and 250 alphanumeric or underscore characters when present.
Maximum length: 250
Minimum length: 1
Pattern: ^[A-Za-z0-9_]+$
$ (anyOf 1).modules[].related_lists[].moduleJSONOptional
$ (anyOf 1).modules[].related_lists[].module (anyOf 1)objectAlternativeModule details associated with this related list entry, including its name and metadata; null if no module is linked.
Additional keys: allowed
$ (anyOf 1).modules[].related_lists[].module (anyOf 2)nullAlternativeModule details associated with this related list entry, including its name and metadata; null if no module is linked.
Additional keys: allowed
$ (anyOf 1).modules[].related_lists[].namestringRequired within parentSystem-level name identifying the related list module; maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].related_lists[].parent_related_listsJSONOptional
$ (anyOf 1).modules[].related_lists[].parent_related_lists (anyOf 1)arrayAlternativeArray of parent related list references when this entry is nested within another related list; null for top-level related lists. Maximum 100 items.
Maximum items: 100
$ (anyOf 1).modules[].related_lists[].parent_related_lists (anyOf 1)[]objectEach itemParent related list reference object containing API name and unique identifier
Additional keys: not allowed
$ (anyOf 1).modules[].related_lists[].parent_related_lists (anyOf 1)[].api_namestringRequired within parentAPI name of the parent related list containing this entry; maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].related_lists[].parent_related_lists (anyOf 1)[].idstringRequired within parentUnique numeric identifier (as string) of the parent related list.
Format: int64
$ (anyOf 1).modules[].related_lists[].parent_related_lists (anyOf 2)nullAlternativeArray of parent related list references when this entry is nested within another related list; null for top-level related lists. Maximum 100 items.
Maximum items: 100
$ (anyOf 1).modules[].related_lists[].parent_related_lists (anyOf 2)[]objectEach itemParent related list reference object containing API name and unique identifier
Additional keys: not allowed
$ (anyOf 1).modules[].related_lists[].parent_related_lists (anyOf 2)[].api_namestringRequired within parentAPI name of the parent related list containing this entry; maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].related_lists[].parent_related_lists (anyOf 2)[].idstringRequired within parentUnique numeric identifier (as string) of the parent related list.
Format: int64
$ (anyOf 1).modules[].related_lists[].personality_namestringOptionalPersonality name assigned to this related list configuration, distinguishing its behavioral variant; maximum 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].related_lists[].record_operationsobjectOptionalSet of allowed record-level operations within this related list, such as create, edit, and assign.
Additional keys: not allowed
$ (anyOf 1).modules[].related_lists[].record_operations.assignbooleanRequired within parentTrue when the assign operation is permitted for records in this related list.
$ (anyOf 1).modules[].related_lists[].record_operations.bulk_editbooleanRequired within parentTrue when bulk edit of records in this related list is permitted for the current user.
$ (anyOf 1).modules[].related_lists[].record_operations.createbooleanRequired within parentTrue when creation of records within this related list is permitted for the current user.
$ (anyOf 1).modules[].related_lists[].record_operations.deletebooleanRequired within parentTrue when deletion of associated records from this related list is permitted for the current user.
$ (anyOf 1).modules[].related_lists[].record_operations.disassociatebooleanRequired within parentTrue when disassociation of records from this related list is permitted for the current user.
$ (anyOf 1).modules[].related_lists[].record_operations.editbooleanRequired within parentTrue when editing of records within this related list is permitted for the current user.
$ (anyOf 1).modules[].related_lists[].sequence_numberstringRequired within parentDisplay position of this related list; lower values appear first.
Format: int32
$ (anyOf 1).modules[].related_lists[].sort_byobjectOptionalField by which records in this related list are sorted by default; contains the field’s API name and unique identifier.
Additional keys: not allowed
$ (anyOf 1).modules[].related_lists[].sort_by.api_namestringRequired within parentAPI name of the field used for sorting, up to 50 characters.
Maximum length: 50
$ (anyOf 1).modules[].related_lists[].sort_by.idstringRequired within parentUnique numeric identifier (as string) of the field used for sorting records in this related list.
Format: int64
$ (anyOf 1).modules[].related_lists[].sort_orderJSONOptional
$ (anyOf 1).modules[].related_lists[].sort_order (anyOf 1)stringAlternativeSort direction applied to records in this related list. Possible values: asc - ascending; desc - descending; null - no sort order configured.
Known values: asc, desc
$ (anyOf 1).modules[].related_lists[].sort_order (anyOf 2)nullAlternativeSort direction applied to records in this related list. Possible values: asc - ascending; desc - descending; null - no sort order configured.
Known values: asc, desc
$ (anyOf 1).modules[].related_lists[].statusstringRequired within parentVisibility status of this related list; currently only ‘visible’ is supported.
Known values: visible
$ (anyOf 1).modules[].related_lists[].typestringRequired within parentClassification of this related list. Possible values: default - standard related list; multiselectlookup - multi-select lookup; combined_view - combined view; custom_lookup - custom lookup; custom_related_list - custom related list; slyteui - Slyte UI; queries - query-based; custom_function - function-based; grouped - grouped list.
Known values: multiselectlookup, combined_view, custom_lookup, custom_related_list, slyteui, queries, custom_function, grouped, default
$ (anyOf 1).modules[].related_lists[].visibilityJSONOptional
$ (anyOf 1).modules[].related_lists[].visibility (anyOf 1)integerAlternativeNumeric code controlling where this related list appears or is hidden in the UI
Format: int32
$ (anyOf 1).modules[].related_lists[].visibility (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).modules[].scoring_supportedbooleanOptionalTrue when lead or contact scoring is supported for this module
$ (anyOf 1).modules[].search_layout_fieldsarrayOptionalUp to 10 fields displayed in the search result layout for this module
Maximum items: 10
$ (anyOf 1).modules[].search_layout_fields[]stringEach itemField reference with API name and unique identifier
Maximum length: 25
$ (anyOf 1).modules[].sequence_numberJSONOptional
$ (anyOf 1).modules[].sequence_number (anyOf 1)integerAlternativeNumeric position of this module in the navigation list; lower values appear first, ranging from 1 to 200
Format: int32
$ (anyOf 1).modules[].sequence_number (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).modules[].show_as_tabbooleanOptionalTrue when this module is rendered as a tab in the navigation UI
$ (anyOf 1).modules[].show_emailparserbooleanOptionalTrue when the Email Parser feature is enabled for this module
$ (anyOf 1).modules[].show_googlesyncbooleanOptionalTrue when Google Contact Sync is enabled for this module
$ (anyOf 1).modules[].show_socialbooleanOptionalTrue when social tab features are enabled for this module
$ (anyOf 1).modules[].show_visitorbooleanOptionalTrue when the ZLiveDesk visitor tracking feature is enabled for this module
$ (anyOf 1).modules[].show_webformbooleanOptionalTrue when the web forms feature is enabled for this module
$ (anyOf 1).modules[].showfacebooksyncbooleanOptionalIndicates if the Facebook LeadChain Sync feature is enabled for this module
$ (anyOf 1).modules[].showleadchainsyncbooleanOptionalTrue when lead chain synchronization is enabled for this module; only exposed for the Leads module
$ (anyOf 1).modules[].showlinkedinsyncbooleanOptionalTrue when the LinkedIn LeadChain Sync feature is enabled for this module
$ (anyOf 1).modules[].showtiktoksyncbooleanOptionalTrue when the TikTok LeadChain Sync feature is enabled for this module
$ (anyOf 1).modules[].singular_labelstringOptionalLocalized singular display label for the module, up to 50 characters
Maximum length: 50
$ (anyOf 1).modules[].sourcestringOptionalOrigin of the module configuration. Possible values: crm - native CRM module; platform_plugin - module from a platform plugin; marketplace_plugin - module from a marketplace plugin; campaign_integration - module created via campaign integration
Known values: crm, platform_plugin, marketplace_plugin, campaign_integration
$ (anyOf 1).modules[].static_subform_propertiesobjectOptionalStatic subform configuration properties defined for fields within this module
Additional keys: not allowed
$ (anyOf 1).modules[].static_subform_properties.fieldsarrayRequired within parentField references included in the static subform, up to 1000 items
Maximum items: 1000
$ (anyOf 1).modules[].static_subform_properties.fields[]objectEach itemField reference with API name and ID
Additional keys: not allowed
$ (anyOf 1).modules[].static_subform_properties.fields[].api_namestringRequired within parentAPI name of the static subform field, up to 50 characters
Maximum length: 50
$ (anyOf 1).modules[].static_subform_properties.fields[].idstringRequired within parentUnique numeric identifier of the static subform field, returned as a string
Format: int64
$ (anyOf 1).modules[].statusstringOptionalRepresents the visibility status of the module. Possible values: visible - module is active and visible; scheduled_for_deletion - module is queued for removal; user_hidden - hidden by user preference; system_hidden - hidden by system configuration
Known values: visible, scheduled_for_deletion, user_hidden, system_hidden
$ (anyOf 1).modules[].sub_menu_availablebooleanOptionalTrue when a submenu is available for this module in the UI navigation
$ (anyOf 1).modules[].territoryJSONOptional
$ (anyOf 1).modules[].territory (anyOf 1)objectAlternativeTerritory restriction applied to the module; null when territory management is not enabled for the organization
Additional keys: not allowed
$ (anyOf 1).modules[].territory (anyOf 1).idstringOptionalUnique identifier of the territory as a string-encoded numeric ID; ‘0’ indicates no territory restriction is applied
Format: int64
$ (anyOf 1).modules[].territory (anyOf 1).namestringOptionalDisplay name of the assigned territory (e.g., ‘All Territories’, ‘North America’)
Maximum length: 50
$ (anyOf 1).modules[].territory (anyOf 1).subordinatesbooleanOptionalTrue when subordinate (child) territories are included within the scope of this territory restriction
$ (anyOf 1).modules[].territory (anyOf 2)nullAlternativeTerritory restriction applied to the module; null when territory management is not enabled for the organization
Additional keys: not allowed
$ (anyOf 1).modules[].territory (anyOf 2).idstringOptionalUnique identifier of the territory as a string-encoded numeric ID; ‘0’ indicates no territory restriction is applied
Format: int64
$ (anyOf 1).modules[].territory (anyOf 2).namestringOptionalDisplay name of the assigned territory (e.g., ‘All Territories’, ‘North America’)
Maximum length: 50
$ (anyOf 1).modules[].territory (anyOf 2).subordinatesbooleanOptionalTrue when subordinate (child) territories are included within the scope of this territory restriction
$ (anyOf 1).modules[].track_current_databooleanOptionalTrue when current data tracking is enabled for records in this module
$ (anyOf 1).modules[].triggers_supportedbooleanOptionalTrue when workflow triggers are supported for this module
$ (anyOf 1).modules[].viewablebooleanOptionalTrue when records in this module can be viewed by the current user
$ (anyOf 1).modules[].visibilityJSONOptional
$ (anyOf 1).modules[].visibility (anyOf 1)integerAlternativeBitwise integer flags controlling module and feature visibility, ranging from 1 to 16383. Base value 1 means fully visible. Add flag values to suppress specific UI surfaces: 2=web UI hidden, 4=tab menu, 8=lookup, 16=related list, 32=multi-select lookup, 64=module settings, 128=automation, 256=templates, 512=import, 1024=export, 4096=reports, 8192=API.
Format: int32
Maximum: 16383
Minimum: 1
$ (anyOf 1).modules[].visibility (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 1).modules[].web_linkJSONOptional
$ (anyOf 1).modules[].web_link (anyOf 1)stringAlternativeURL associated with this module; null when no web link is configured
$ (anyOf 1).modules[].web_link (anyOf 2)nullAlternativeURL associated with this module; null when no web link is configured
$ (anyOf 1).modules[].webform_supportedbooleanOptionalTrue when web forms can be created for this module
$ (anyOf 1).modules[].zia_viewbooleanOptionalTrue when Zia AI view is enabled for this module; applicable only to the Deals module
$ (anyOf 2)nullAlternative

Referenced models: Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views created by id, name — shared_created-by_0a006039d025, Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views created by id, name — shared_created-by_eeb47d537d32, Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views criteria comparator, field, type, value, Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views fields item, Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views module, Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_47bbdc5a1afb, Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_974890dad625, Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views sort by api name, id — shared_sort-by_7f4ade2b2bbe, Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views sort by api name, id — shared_sort-by_9fe373614add

Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views created by id, name — shared_created-by_0a006039d025
FieldTypePresenceDescription and constraints
$nullRootUser object identifying who created this custom view, containing id and name. Null for system-generated views.
Additional keys: not allowed
idstringRequired within parentUnique numeric identifier (as string) of the CRM user who created this custom view.
Format: int64
namestringRequired within parentDisplay name of the CRM user who created this custom view. Maximum 101 characters.
Maximum length: 101
Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views created by id, name — shared_created-by_eeb47d537d32
FieldTypePresenceDescription and constraints
$objectRootUser object identifying who created this custom view, containing id and name. Null for system-generated views.
Additional keys: not allowed
idstringRequired within parentUnique numeric identifier (as string) of the CRM user who created this custom view.
Format: int64
namestringRequired within parentDisplay name of the CRM user who created this custom view. Maximum 101 characters.
Maximum length: 101
Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views criteria comparator, field, type, value
FieldTypePresenceDescription and constraints
$objectRootSingle filter criterion defining a field comparison condition.
Additional keys: not allowed
comparatorstringRequired within parentComparison operator used for filtering (e.g., equal, contains, greater_than, less_than).
Maximum length: 15
fieldobjectRequired within parentField reference specifying which field to filter on.
Additional keys: not allowed
field.api_namestringRequired within parentAPI name of the field to filter.
Maximum length: 50
field.idstringRequired within parentUnique identifier of the field.
Format: int64
typestringRequired within parenttype of the field being filtered.
Maximum length: 50
valueJSONRequired within parentFilter value to compare against. Can be boolean, string, number, object, array, or null depending on field type and comparator.
Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views fields item
FieldTypePresenceDescription and constraints
$objectRootField configuration specifying which field to show and display settings.
Additional keys: not allowed
_pinbooleanRequired within parentTrue when this field column is pinned in the custom view, keeping it visible during horizontal scrolling.
api_namestringRequired within parentAPI name of the field displayed as this view column. Maximum 50 characters.
Maximum length: 50
idstringRequired within parentUnique numeric identifier (as string) of the field displayed as this view column.
Format: int64
Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views module
FieldTypePresenceDescription and constraints
$objectRootReference object identifying the module to which this custom view belongs, containing the module's unique identifier and API name. This is exposed only for client calls.
Additional keys: not allowed
api_namestringRequired within parentAPI name of the module this custom view belongs to. Maximum 50 characters.
Maximum length: 50
idstringRequired within parentUnique numeric identifier (as string) of the module this custom view belongs to.
Format: int64
Get module metadata by API name — request body — path
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
moduleIdentifierJSONRequired within parent
moduleIdentifier (anyOf 1)stringAlternativeUnique numeric identifier. Numeric string representation of a 64-bit positive integer.
Format: int64
moduleIdentifier (anyOf 2)stringAlternativeAPI name of the module to retrieve. Case-sensitive identifier following specific naming rules: must start with a letter, contain only alphanumeric characters and underscores, cannot have consecutive underscores, and must end with alphanumeric character.
Maximum length: 50
Pattern: ^[A-Za-z][A-Za-z0-9_]*[A-Za-z0-9]$
Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_47bbdc5a1afb
FieldTypePresenceDescription and constraints
$objectRootShare target with subordinates included.
Additional keys: not allowed
idstringRequired within parentUnique identifier of the entity.
Format: int64
namestringRequired within parentName of the entity (user, role, group, or territory).
Maximum length: 50
subordinatesJSONRequired within parent
subordinates (anyOf 1)booleanAlternativeIndicates if subordinates of the specified entity are included in sharing.
Known values: True
subordinates (anyOf 2)nullAlternativeIndicates if subordinates of the specified entity are included in sharing.
Known values: True
typestringRequired within parentType of entity the view is shared with (territories, roles, groups, users).
Known values: territories, roles, groups, users
Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views shared to null item type: territories, roles, groups, users — shared_shared-to_974890dad625
FieldTypePresenceDescription and constraints
$objectRootShare target without subordinates.
Additional keys: not allowed
idstringRequired within parentUnique identifier of the entity.
Format: int64
namestringRequired within parentName of the entity (user, role, group, or territory).
Maximum length: 50
subordinatesJSONRequired within parent
subordinates (anyOf 1)booleanAlternativeIndicates if subordinates are excluded from sharing.
Known values: False
subordinates (anyOf 2)nullAlternativeIndicates if subordinates are excluded from sharing.
Known values: False
typestringRequired within parentType of entity the view is shared with (territories, roles, groups, users).
Known values: territories, roles, groups, users
Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views sort by api name, id — shared_sort-by_7f4ade2b2bbe
FieldTypePresenceDescription and constraints
$objectRootField object specifying the column used to sort records in this view, containing api_name and id. Null when no sort field is configured.
Additional keys: not allowed
api_namestringRequired within parentAPI name of the field used as the sort column in this view. Maximum 50 characters.
Maximum length: 50
idstringRequired within parentUnique numeric identifier (as string) of the field used as the sort column in this view.
Format: int64
Get module metadata by API name — response body — modules / modules / item / custom_view / access_type: shared, public, only to me, category: created by me, shared with me, public views sort by api name, id — shared_sort-by_9fe373614add
FieldTypePresenceDescription and constraints
$nullRootField object specifying the column used to sort records in this view, containing api_name and id. Null when no sort field is configured.
Additional keys: not allowed
api_namestringRequired within parentAPI name of the field used as the sort column in this view. Maximum 50 characters.
Maximum length: 50
idstringRequired within parentUnique numeric identifier (as string) of the field used as the sort column in this view.
Format: int64

SDK function policy ID: zoho.getmodulebyapiname. Catalog operation: getModuleByApiName. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

No-content response statuses: [204]

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.