---
title: "Preview alert widget"
method: POST
path: "/api/2.0/alerts/preview"
---

# Preview alert widget

`POST /api/2.0/alerts/preview`

## Request body

- DatasetAlert — Alert information
  - `createdDate` integer — Created date in milliseconds
  - `lastModDate` integer — Last modified date
  - `id` integer — Alert ID
  - `datasetId` integer — Dataset ID
  - `lastAlert` string, date-time — Last alert date
  - `userId` integer — Alert owner's user ID
  - `status` integer — Alert status
  - `alertCondition` string — Alert condition for conditional alert type
  - `alertName` string — Alert name
  - `alertType` integer — Alert type
  - `accessLevel` integer — Access level of the alert for current user
  - `autoShared` boolean — Is alert auto-shared on
  - `schedule` Schedule — Schedule information
    - `frequencyType` string, required — Frequency type
    - `frequency` integer, required — Frequency count
    - `startTime` string — Start time. This can either be time HH:mm or date time MM/dd/yyyy HH:mm
    - `nextExecutionTime` integer — Next execution time in milliseconds
  - `realtime` boolean — Whether or not this alert is real-time alert
  - `executionReport` ExecutionReport[]
    - `executionDate` integer — Date in milliseconds
    - `executionStatus` 'UNKNOWN' | 'RUNNING' | 'SUCCESS' | 'FAILURE' | 'ALERT' | 'TIMEOUT' — Status
    - `duration` integer — Duration
    - `details` ActionApiResponse[] — Details
      - `ok` boolean — Whether or not the response is a success
      - `channel` 'EMAIL' | 'WEBHOOK' | 'SLACK' | 'TEAMS' — Channel
      - `message` string — Action result details message
  - `firedCount` integer — Number of times this alert has been triggered
  - `createdBy` string — Alert owner's username
  - `deletable` boolean — Whether or not the current user has deletion right to the alert
  - `chartId` integer — Widget ID
  - `properties` DatasetAlertProperties, required — Alert properties
    - `emailOutput` EmailOutput — Email output properties
      - `from` string — Email from
      - `replyTo` string — Email reply to
      - `sendTo` string — Email send to
      - `cc` string — Email cc
      - `bcc` string — Email bcc
      - `emailSubject` string — Email subject
      - `emailBody` string — Email body
    - `webhookOutput` WebhookOutput — Webhook output properties
      - `selectedWebhooks` integer[] — Webhook IDs
    - `slackOutput` SlackOutput — Slack output properties
      - `selectedSlacks` integer[] — Slack IDs
    - `teamsOutput` TeamsOutput — Teams output properties
      - `selectedTeams` integer[] — Teams IDs
    - `dashboardPdfInfo` DashboardPdfInfo — Dashboard PDF information
      - `dashboardPdfId` integer — Additional C9QL to be applied prior to attachment
    - `alertIfNoData` boolean — Whether or not to send alert of there is no data returned
    - `skipSameAlert` boolean — Whether or not to send alert if data is the same as previous alert
    - `attachDataset` boolean — Whether or not to attach raw dataset data
    - `attachAlertData` boolean — Whether or not to attach raw dataset data
    - `attachmentConfig` AttachmentConfig — Attachment config
      - `datasetId` integer — Dataset ID to replace the alert's dataset ID for attachment
      - `query` string — Additional C9QL to be applied prior to attachment
    - `anomalyId` integer — Anomaly definition ID
    - `anomalyLookBack` string — Anomaly lookback period
    - `frequencyMarker` string — Alert frequency in minutes or "custom"
    - `operator` string — Alert/anomaly condition operator
    - `metric` string — Alert/anomaly metric field
    - `dimension` string — Anomaly dimension field
    - `threshold` string — Alert/anomaly threshold value
    - `dateTime` string — Anomaly date/time field
    - `alertContentFilters` Filter[] — Alert content filters
      - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
      - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
      - `values` object[] — Filter values
      - `operator` string — Filter operator
      - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
      - `requireValue` boolean — Whether or not filter requires value to be set
      - `enabled` boolean — Whether or not filter is enabled (default is true)
      - `controlType` string — Filter control type
      - `visible` boolean — Whether or not filter is visible (default is true)
      - `hitList` integer — Suggestion values dataset ID
      - `hitListLabel` string — Suggestion label field name of the hit list dataset
      - `hitListValue` string — Suggestion value field name of the hit list dataset
      - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
      - `label` string — Display label for the filter
      - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
      - `description` string — Filter description
      - `dateLimit` string — Filter date limit
      - `dateLimitOptions` string — Filter date limit options (restriction and from token)
      - `displayValues` object[] — Custom display values
      - `plainControlType` string — Control type for plain text field type
      - `dynamic` boolean — Whether or not filter's value is automatically selected
      - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)

## Response `200`

Success

- Widget — Widget information
  - `createdDate` integer — Created date in milliseconds
  - `lastModDate` integer — Last modified date
  - `id` integer — Widget ID
  - `name` string — Widget name
  - `userId` integer — Widget owner's user ID
  - `customerId` integer — Widget owner's customer ID
  - `datasetId` integer — Dataset ID
  - `type` integer — Widget type
  - `description` string — Widget description
  - `refreshChartMillis` integer
  - `shareUrl` string — Share URL identifier
  - `secureShareUrl` string — Secure share URL identifier
  - `accessLevel` integer — Access level of the report for current user
  - `certified` boolean
  - `autoShared` boolean — Is report auto-shared on
  - `urlShareWhitelistDomain` string[]
  - `filterSettings` string
  - `chartType` string
  - `alertCount` integer
  - `incognitoId` integer
  - `queryId` integer
  - `queryStr` string
  - `adhocQuery` string
  - `categories` integer[]
  - `widgetCache` WidgetCacheInfo
    - `enabled` boolean
    - `mode` string
    - `state` string
    - `refreshing` boolean
    - `staleReason` string
    - `lastUpdatedAt` integer
  - `associations` ChartAssociations
    - `widgetId` integer
    - `drilldowns` Drilldown[]
      - `field` string
      - `value` object
      - `legend` string
      - `id` integer
      - `type` 'widget' | 'dashboard' | 'dashboard_connected'
      - `filters` Filter[]
        - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
        - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
        - `values` object[] — Filter values
        - `operator` string — Filter operator
        - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
        - `requireValue` boolean — Whether or not filter requires value to be set
        - `enabled` boolean — Whether or not filter is enabled (default is true)
        - `controlType` string — Filter control type
        - `visible` boolean — Whether or not filter is visible (default is true)
        - `hitList` integer — Suggestion values dataset ID
        - `hitListLabel` string — Suggestion label field name of the hit list dataset
        - `hitListValue` string — Suggestion value field name of the hit list dataset
        - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
        - `label` string — Display label for the filter
        - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
        - `description` string — Filter description
        - `dateLimit` string — Filter date limit
        - `dateLimitOptions` string — Filter date limit options (restriction and from token)
        - `displayValues` object[] — Custom display values
        - `plainControlType` string — Control type for plain text field type
        - `dynamic` boolean — Whether or not filter's value is automatically selected
        - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
      - `c9Query` string
      - `passingFilters` boolean
      - `passingDrilldownFilters` boolean
  - `queryModified` boolean
  - `updateFilters` boolean
  - `dataFields` string[]
  - `dataFieldsTypes` object
  - `typeModified` boolean
  - `lastSyncDate` string, date-time
  - `viewOnly` boolean
  - `truncated` string[]
  - `processedName` string
  - `processedDescription` string
  - `processedFootNote` string
  - `error` string
  - `pagination` object
  - `pagedDataTransformationWarning` string
  - `processedChartProperties` object
  - `widgetConfig` WidgetConfig
    - `createdDate` integer — Created date in milliseconds
    - `lastModDate` integer — Last modified date
    - `filters` Filter[]
      - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
      - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
      - `values` object[] — Filter values
      - `operator` string — Filter operator
      - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
      - `requireValue` boolean — Whether or not filter requires value to be set
      - `enabled` boolean — Whether or not filter is enabled (default is true)
      - `controlType` string — Filter control type
      - `visible` boolean — Whether or not filter is visible (default is true)
      - `hitList` integer — Suggestion values dataset ID
      - `hitListLabel` string — Suggestion label field name of the hit list dataset
      - `hitListValue` string — Suggestion value field name of the hit list dataset
      - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
      - `label` string — Display label for the filter
      - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
      - `description` string — Filter description
      - `dateLimit` string — Filter date limit
      - `dateLimitOptions` string — Filter date limit options (restriction and from token)
      - `displayValues` object[] — Custom display values
      - `plainControlType` string — Control type for plain text field type
      - `dynamic` boolean — Whether or not filter's value is automatically selected
      - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
    - `fields` SimpleField[]
      - `fieldName` string
      - `displayType` DisplayType
        - `format` string
      - `nestedFields` SimpleField[]
      - `ntz` boolean
    - `macroFields` SimpleField[]
      - `fieldName` string
      - `displayType` DisplayType
        - `format` string
      - `nestedFields` SimpleField[]
      - `ntz` boolean
    - `defaultFilters` Filter[]
      - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
      - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
      - `values` object[] — Filter values
      - `operator` string — Filter operator
      - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
      - `requireValue` boolean — Whether or not filter requires value to be set
      - `enabled` boolean — Whether or not filter is enabled (default is true)
      - `controlType` string — Filter control type
      - `visible` boolean — Whether or not filter is visible (default is true)
      - `hitList` integer — Suggestion values dataset ID
      - `hitListLabel` string — Suggestion label field name of the hit list dataset
      - `hitListValue` string — Suggestion value field name of the hit list dataset
      - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
      - `label` string — Display label for the filter
      - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
      - `description` string — Filter description
      - `dateLimit` string — Filter date limit
      - `dateLimitOptions` string — Filter date limit options (restriction and from token)
      - `displayValues` object[] — Custom display values
      - `plainControlType` string — Control type for plain text field type
      - `dynamic` boolean — Whether or not filter's value is automatically selected
      - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
  - `notDefaultFilter` boolean
  - `minMax` object
  - `chartProperties` object
  - `drilldowns` Drilldown[]
    - `field` string
    - `value` object
    - `legend` string
    - `id` integer
    - `type` 'widget' | 'dashboard' | 'dashboard_connected'
    - `filters` Filter[]
      - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
      - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
      - `values` object[] — Filter values
      - `operator` string — Filter operator
      - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
      - `requireValue` boolean — Whether or not filter requires value to be set
      - `enabled` boolean — Whether or not filter is enabled (default is true)
      - `controlType` string — Filter control type
      - `visible` boolean — Whether or not filter is visible (default is true)
      - `hitList` integer — Suggestion values dataset ID
      - `hitListLabel` string — Suggestion label field name of the hit list dataset
      - `hitListValue` string — Suggestion value field name of the hit list dataset
      - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
      - `label` string — Display label for the filter
      - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
      - `description` string — Filter description
      - `dateLimit` string — Filter date limit
      - `dateLimitOptions` string — Filter date limit options (restriction and from token)
      - `displayValues` object[] — Custom display values
      - `plainControlType` string — Control type for plain text field type
      - `dynamic` boolean — Whether or not filter's value is automatically selected
      - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
    - `c9Query` string
    - `passingFilters` boolean
    - `passingDrilldownFilters` boolean
  - `filters` Filter[]
    - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
    - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
    - `values` object[] — Filter values
    - `operator` string — Filter operator
    - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
    - `requireValue` boolean — Whether or not filter requires value to be set
    - `enabled` boolean — Whether or not filter is enabled (default is true)
    - `controlType` string — Filter control type
    - `visible` boolean — Whether or not filter is visible (default is true)
    - `hitList` integer — Suggestion values dataset ID
    - `hitListLabel` string — Suggestion label field name of the hit list dataset
    - `hitListValue` string — Suggestion value field name of the hit list dataset
    - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
    - `label` string — Display label for the filter
    - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
    - `description` string — Filter description
    - `dateLimit` string — Filter date limit
    - `dateLimitOptions` string — Filter date limit options (restriction and from token)
    - `displayValues` object[] — Custom display values
    - `plainControlType` string — Control type for plain text field type
    - `dynamic` boolean — Whether or not filter's value is automatically selected
    - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
  - `widgetAccessLevel` integer
  - `chartPropertiesNullOrEmpty` boolean
  - `user` User — User information
    - `createdDate` integer — Created date in milliseconds
    - `lastModDate` integer — Last modified date
    - `id` integer — User ID
    - `username` string — User username
    - `name` string — User name
    - `ssoUser` boolean — Is SSO user
    - `customerId` integer — User customer ID
    - `autocycle` boolean — Is user eligible for auto-cycle
    - `timeZone` string — User timezone
    - `lastLoginDate` string, date-time — User last login date time
    - `managementClientId` string — Management API client ID
    - `managementClientSecret` string — Management API client secret
    - `externalAuthType` integer — External authentication type
    - `userGroups` UserGroup[] — Groups
      - `createdDate` integer — Created date in milliseconds
      - `lastModDate` integer — Last modified date
      - `id` integer — Group ID
      - `groupName` string, required — Group name
      - `userName` string — Group owner's username
      - `userId` integer — Group owner's user ID
      - `limitSharing` boolean — If true, this user can only share assets with members of this group
      - `accessLevel` integer — User's access level for this group (0=Admin, 1=Edit, 2=View)
      - `contentFilters` Filter[] — Group content filters
        - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
        - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
        - `values` object[] — Filter values
        - `operator` string — Filter operator
        - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
        - `requireValue` boolean — Whether or not filter requires value to be set
        - `enabled` boolean — Whether or not filter is enabled (default is true)
        - `controlType` string — Filter control type
        - `visible` boolean — Whether or not filter is visible (default is true)
        - `hitList` integer — Suggestion values dataset ID
        - `hitListLabel` string — Suggestion label field name of the hit list dataset
        - `hitListValue` string — Suggestion value field name of the hit list dataset
        - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
        - `label` string — Display label for the filter
        - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
        - `description` string — Filter description
        - `dateLimit` string — Filter date limit
        - `dateLimitOptions` string — Filter date limit options (restriction and from token)
        - `displayValues` object[] — Custom display values
        - `plainControlType` string — Control type for plain text field type
        - `dynamic` boolean — Whether or not filter's value is automatically selected
        - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
    - `userProperties` UserProperties — User properties
      - `adminUserLimit` integer
      - `dashboardSharing` boolean
      - `elasticStoreLimit` integer
      - `machineLearningAccess` boolean
      - `managementAPI` boolean
      - `urlSharePasswordProtect` boolean
      - `customerSsoGenerateUI` boolean
      - `ssoUserLimit` integer
      - `triggerNotificationAccess` boolean
      - `insightEnabled` boolean
      - `insightIconDefaultEnabled` boolean
      - `searchBarMode` string
      - `nlpEnabled` boolean
      - `botNlpEnabled` boolean
      - `unstructuredDataNlpEnabled` boolean
      - `allowCustomerUseNlp` boolean
      - `allowCustomerUseBotNlp` boolean
      - `nlpIndexByDefault` boolean
      - `ldap` boolean
      - `saml` boolean
      - `userLimit` integer
      - `widgetCountLimit` integer
      - `viewerUserLimit` integer
      - `nlpVisualizationFirstEnabled` boolean
      - `appsEnabled` boolean
      - `appsLimit` integer
      - `forceTwoFactorAuthEnabled` string
      - `newDashNavEnabled` boolean
      - `font` string
      - `selectedDashboardId` integer
      - `defaultDashboardId` integer
      - `sendTimezoneWithQuery` boolean
      - `directPush` boolean
      - `writeBack` boolean
      - `userContentFilters` Filter[]
        - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
        - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
        - `values` object[] — Filter values
        - `operator` string — Filter operator
        - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
        - `requireValue` boolean — Whether or not filter requires value to be set
        - `enabled` boolean — Whether or not filter is enabled (default is true)
        - `controlType` string — Filter control type
        - `visible` boolean — Whether or not filter is visible (default is true)
        - `hitList` integer — Suggestion values dataset ID
        - `hitListLabel` string — Suggestion label field name of the hit list dataset
        - `hitListValue` string — Suggestion value field name of the hit list dataset
        - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
        - `label` string — Display label for the filter
        - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
        - `description` string — Filter description
        - `dateLimit` string — Filter date limit
        - `dateLimitOptions` string — Filter date limit options (restriction and from token)
        - `displayValues` object[] — Custom display values
        - `plainControlType` string — Control type for plain text field type
        - `dynamic` boolean — Whether or not filter's value is automatically selected
        - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
      - `customerContentFilters` Filter[]
        - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
        - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
        - `values` object[] — Filter values
        - `operator` string — Filter operator
        - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
        - `requireValue` boolean — Whether or not filter requires value to be set
        - `enabled` boolean — Whether or not filter is enabled (default is true)
        - `controlType` string — Filter control type
        - `visible` boolean — Whether or not filter is visible (default is true)
        - `hitList` integer — Suggestion values dataset ID
        - `hitListLabel` string — Suggestion label field name of the hit list dataset
        - `hitListValue` string — Suggestion value field name of the hit list dataset
        - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
        - `label` string — Display label for the filter
        - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
        - `description` string — Filter description
        - `dateLimit` string — Filter date limit
        - `dateLimitOptions` string — Filter date limit options (restriction and from token)
        - `displayValues` object[] — Custom display values
        - `plainControlType` string — Control type for plain text field type
        - `dynamic` boolean — Whether or not filter's value is automatically selected
        - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
      - `groupContentFilters` Filter[]
        - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
        - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
        - `values` object[] — Filter values
        - `operator` string — Filter operator
        - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
        - `requireValue` boolean — Whether or not filter requires value to be set
        - `enabled` boolean — Whether or not filter is enabled (default is true)
        - `controlType` string — Filter control type
        - `visible` boolean — Whether or not filter is visible (default is true)
        - `hitList` integer — Suggestion values dataset ID
        - `hitListLabel` string — Suggestion label field name of the hit list dataset
        - `hitListValue` string — Suggestion value field name of the hit list dataset
        - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
        - `label` string — Display label for the filter
        - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
        - `description` string — Filter description
        - `dateLimit` string — Filter date limit
        - `dateLimitOptions` string — Filter date limit options (restriction and from token)
        - `displayValues` object[] — Custom display values
        - `plainControlType` string — Control type for plain text field type
        - `dynamic` boolean — Whether or not filter's value is automatically selected
        - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
      - `sharedContentFilters` Filter[]
        - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
        - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
        - `values` object[] — Filter values
        - `operator` string — Filter operator
        - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
        - `requireValue` boolean — Whether or not filter requires value to be set
        - `enabled` boolean — Whether or not filter is enabled (default is true)
        - `controlType` string — Filter control type
        - `visible` boolean — Whether or not filter is visible (default is true)
        - `hitList` integer — Suggestion values dataset ID
        - `hitListLabel` string — Suggestion label field name of the hit list dataset
        - `hitListValue` string — Suggestion value field name of the hit list dataset
        - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
        - `label` string — Display label for the filter
        - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
        - `description` string — Filter description
        - `dateLimit` string — Filter date limit
        - `dateLimitOptions` string — Filter date limit options (restriction and from token)
        - `displayValues` object[] — Custom display values
        - `plainControlType` string — Control type for plain text field type
        - `dynamic` boolean — Whether or not filter's value is automatically selected
        - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
      - `contentFilters` Filter[]
        - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
        - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
        - `values` object[] — Filter values
        - `operator` string — Filter operator
        - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
        - `requireValue` boolean — Whether or not filter requires value to be set
        - `enabled` boolean — Whether or not filter is enabled (default is true)
        - `controlType` string — Filter control type
        - `visible` boolean — Whether or not filter is visible (default is true)
        - `hitList` integer — Suggestion values dataset ID
        - `hitListLabel` string — Suggestion label field name of the hit list dataset
        - `hitListValue` string — Suggestion value field name of the hit list dataset
        - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
        - `label` string — Display label for the filter
        - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
        - `description` string — Filter description
        - `dateLimit` string — Filter date limit
        - `dateLimitOptions` string — Filter date limit options (restriction and from token)
        - `displayValues` object[] — Custom display values
        - `plainControlType` string — Control type for plain text field type
        - `dynamic` boolean — Whether or not filter's value is automatically selected
        - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
      - `schemaSample` integer
      - `schemaNestedSample` integer
      - `maxChunkSize` integer
      - `maxChunkCount` integer
      - `maxQueryTime` integer
      - `locale` string
      - `defaultTimeZone` string
      - `customUserColors` string
      - `customFieldColors` string
      - `customerLogo` string
      - `customerThemes` string
      - `activeThemeId` string
      - `dateFormat` string
      - `defaultDateFormat` string
      - `customMailServer` string
      - `defaultCategoryPermission` integer
      - `subAccountAccess` boolean
      - `systemAdmin` boolean
      - `logoutUrl` string
      - `supportEmail` string
      - `pdfEngine` string
      - `tunnelPrivateKey` string
      - `tunnelPublicKey` string
      - `tunnelKeyPassphrase` string
      - `limitListingUsersToGroups` boolean
      - `aiAssistantEnabled` boolean
      - `aiAgentsEnabled` boolean
      - `aiAgentsUiToggle` boolean
      - `agenticBIUseDocs` string
      - `agenticBIUseDatasets` string
      - `agenticBIUseWidgets` string
      - `agenticBIUseDashboards` string
      - `agenticBIUseReports` string
      - `agenticBIUseAlerts` string
      - `agenticBIModel` string
      - `agenticBISelectedDatasets` string
      - `agenticBISelectedDocs` string
      - `onboardingChecklistState` string
      - `aiProviderSettings` object
      - `customSupportEmail` string
      - `oem` boolean
      - `hasOpenAIKey` boolean
      - `hasAnthropicKey` boolean
      - `hasGeminiKey` boolean
      - `hasAzureAIKey` boolean
      - `totalUserLimit` integer
    - `roles` string[] — User roles
    - `permissions` string[] — User permissions
    - `jsonConfig` string — Role JSON config (viz settings, etc.)
    - `twoFactorBySms` boolean — Is two factor login by SMS enabled
    - `phone` string — User phone number
    - `twoFactorByEmail` boolean — Is two factor login by EMAIL enabled
    - `email` string — User email
    - `selectedDashInternal` Dashboard
      - `createdDate` string, date-time
      - `lastModDate` integer — Last modified date
      - `id` integer
      - `oid` integer
      - `name` string
      - `userId` integer
      - `url` string
      - `secureUrl` string
      - `urlShareWhitelistDomain` string
      - `displayOrder` integer
      - `screenAdjust` boolean
      - `screenWidth` integer
      - `screenHeight` integer
      - `lastModDt` string, date-time
      - `lastAccessDt` string, date-time
      - `locked` boolean
      - `accessLevel` integer
      - `categoryAccessLevel` integer
      - `autoShared` boolean
      - `filterSettings` string
      - `favorite` boolean
      - `urlSharePassword` string
      - `incognitoId` integer
      - `type` integer
      - `username` string
      - `defaultFilterSets` FilterSet[]
        - `createdDate` integer — Created date in milliseconds
        - `lastModDate` integer — Last modified date
        - `id` integer
        - `userId` integer
        - `name` string
        - `accessLevel` integer
        - `userSpecific` boolean
        - `enabled` boolean
        - `color` string
        - `defaultFilters` boolean
        - `locked` boolean
        - `visible` boolean
        - `syncFilters` boolean
        - `expanded` boolean
        - `filters` Filter[]
          - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
          - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
          - `values` object[] — Filter values
          - `operator` string — Filter operator
          - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
          - `requireValue` boolean — Whether or not filter requires value to be set
          - `enabled` boolean — Whether or not filter is enabled (default is true)
          - `controlType` string — Filter control type
          - `visible` boolean — Whether or not filter is visible (default is true)
          - `hitList` integer — Suggestion values dataset ID
          - `hitListLabel` string — Suggestion label field name of the hit list dataset
          - `hitListValue` string — Suggestion value field name of the hit list dataset
          - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
          - `label` string — Display label for the filter
          - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
          - `description` string — Filter description
          - `dateLimit` string — Filter date limit
          - `dateLimitOptions` string — Filter date limit options (restriction and from token)
          - `displayValues` object[] — Custom display values
          - `plainControlType` string — Control type for plain text field type
          - `dynamic` boolean — Whether or not filter's value is automatically selected
          - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
        - `transientFilter` boolean
      - `categories` integer[]
      - `notDefaultFilter` boolean
      - `properties` DashboardProps
        - `createdDate` integer — Created date in milliseconds
        - `lastModDate` integer — Last modified date
        - `theme` string
        - `description` string
        - `header` string
        - `footer` string
        - `customCssJs` string
        - `excludeGridWidgetsFromPdfExport` boolean
        - `excludeExpandedGridFromPdfExport` boolean
        - `filters` Filter[]
          - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
          - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
          - `values` object[] — Filter values
          - `operator` string — Filter operator
          - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
          - `requireValue` boolean — Whether or not filter requires value to be set
          - `enabled` boolean — Whether or not filter is enabled (default is true)
          - `controlType` string — Filter control type
          - `visible` boolean — Whether or not filter is visible (default is true)
          - `hitList` integer — Suggestion values dataset ID
          - `hitListLabel` string — Suggestion label field name of the hit list dataset
          - `hitListValue` string — Suggestion value field name of the hit list dataset
          - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
          - `label` string — Display label for the filter
          - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
          - `description` string — Filter description
          - `dateLimit` string — Filter date limit
          - `dateLimitOptions` string — Filter date limit options (restriction and from token)
          - `displayValues` object[] — Custom display values
          - `plainControlType` string — Control type for plain text field type
          - `dynamic` boolean — Whether or not filter's value is automatically selected
          - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
        - `pdfViewportWidth` integer
        - `pdfViewportHeight` integer
        - `pdfExportSettings` object
        - `defaultFilters` Filter[]
          - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
          - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
          - `values` object[] — Filter values
          - `operator` string — Filter operator
          - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
          - `requireValue` boolean — Whether or not filter requires value to be set
          - `enabled` boolean — Whether or not filter is enabled (default is true)
          - `controlType` string — Filter control type
          - `visible` boolean — Whether or not filter is visible (default is true)
          - `hitList` integer — Suggestion values dataset ID
          - `hitListLabel` string — Suggestion label field name of the hit list dataset
          - `hitListValue` string — Suggestion value field name of the hit list dataset
          - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
          - `label` string — Display label for the filter
          - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
          - `description` string — Filter description
          - `dateLimit` string — Filter date limit
          - `dateLimitOptions` string — Filter date limit options (restriction and from token)
          - `displayValues` object[] — Custom display values
          - `plainControlType` string — Control type for plain text field type
          - `dynamic` boolean — Whether or not filter's value is automatically selected
          - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
        - `filterSets` FilterSet[]
          - `createdDate` integer — Created date in milliseconds
          - `lastModDate` integer — Last modified date
          - `id` integer
          - `userId` integer
          - `name` string
          - `accessLevel` integer
          - `userSpecific` boolean
          - `enabled` boolean
          - `color` string
          - `defaultFilters` boolean
          - `locked` boolean
          - `visible` boolean
          - `syncFilters` boolean
          - `expanded` boolean
          - `filters` Filter[]
            - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
            - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
            - `values` object[] — Filter values
              - …
            - `operator` string — Filter operator
            - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
            - `requireValue` boolean — Whether or not filter requires value to be set
            - `enabled` boolean — Whether or not filter is enabled (default is true)
            - `controlType` string — Filter control type
            - `visible` boolean — Whether or not filter is visible (default is true)
            - `hitList` integer — Suggestion values dataset ID
            - `hitListLabel` string — Suggestion label field name of the hit list dataset
            - `hitListValue` string — Suggestion value field name of the hit list dataset
            - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
            - `label` string — Display label for the filter
            - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
            - `description` string — Filter description
            - `dateLimit` string — Filter date limit
            - `dateLimitOptions` string — Filter date limit options (restriction and from token)
            - `displayValues` object[] — Custom display values
              - …
            - `plainControlType` string — Control type for plain text field type
            - `dynamic` boolean — Whether or not filter's value is automatically selected
            - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
          - `transientFilter` boolean
        - `defaultFilterSets` FilterSet[]
          - `createdDate` integer — Created date in milliseconds
          - `lastModDate` integer — Last modified date
          - `id` integer
          - `userId` integer
          - `name` string
          - `accessLevel` integer
          - `userSpecific` boolean
          - `enabled` boolean
          - `color` string
          - `defaultFilters` boolean
          - `locked` boolean
          - `visible` boolean
          - `syncFilters` boolean
          - `expanded` boolean
          - `filters` Filter[]
            - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
            - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
            - `values` object[] — Filter values
              - …
            - `operator` string — Filter operator
            - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
            - `requireValue` boolean — Whether or not filter requires value to be set
            - `enabled` boolean — Whether or not filter is enabled (default is true)
            - `controlType` string — Filter control type
            - `visible` boolean — Whether or not filter is visible (default is true)
            - `hitList` integer — Suggestion values dataset ID
            - `hitListLabel` string — Suggestion label field name of the hit list dataset
            - `hitListValue` string — Suggestion value field name of the hit list dataset
            - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
            - `label` string — Display label for the filter
            - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
            - `description` string — Filter description
            - `dateLimit` string — Filter date limit
            - `dateLimitOptions` string — Filter date limit options (restriction and from token)
            - `displayValues` object[] — Custom display values
              - …
            - `plainControlType` string — Control type for plain text field type
            - `dynamic` boolean — Whether or not filter's value is automatically selected
            - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
          - `transientFilter` boolean
        - `view` object
        - `dashboardGroupingList` integer[]
        - `dashboardGroupingMap` array[]
          - object[]
      - `my` boolean
      - `orderedPositions` ChartPosition[]
        - `chartId` integer
        - `width` integer
        - `height` integer
        - `originalScreenWidth` integer
        - `originalScreenHeight` integer
        - `col` integer
        - `row` integer
        - `xpos` integer
        - `ypos` integer
        - `id` integer
        - `size_x` integer
        - `size_y` integer
        - `size_y_original` integer
        - `grain` integer
      - `showWidgetList` boolean
      - `dashboardGroupingOriginId` object
      - `dashNameAsValidFilename` string
      - `dashboardGroupingViewOnly` boolean
      - `propertiesInternally` DashboardProps
        - `createdDate` integer — Created date in milliseconds
        - `lastModDate` integer — Last modified date
        - `theme` string
        - `description` string
        - `header` string
        - `footer` string
        - `customCssJs` string
        - `excludeGridWidgetsFromPdfExport` boolean
        - `excludeExpandedGridFromPdfExport` boolean
        - `filters` Filter[]
          - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
          - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
          - `values` object[] — Filter values
          - `operator` string — Filter operator
          - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
          - `requireValue` boolean — Whether or not filter requires value to be set
          - `enabled` boolean — Whether or not filter is enabled (default is true)
          - `controlType` string — Filter control type
          - `visible` boolean — Whether or not filter is visible (default is true)
          - `hitList` integer — Suggestion values dataset ID
          - `hitListLabel` string — Suggestion label field name of the hit list dataset
          - `hitListValue` string — Suggestion value field name of the hit list dataset
          - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
          - `label` string — Display label for the filter
          - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
          - `description` string — Filter description
          - `dateLimit` string — Filter date limit
          - `dateLimitOptions` string — Filter date limit options (restriction and from token)
          - `displayValues` object[] — Custom display values
          - `plainControlType` string — Control type for plain text field type
          - `dynamic` boolean — Whether or not filter's value is automatically selected
          - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
        - `pdfViewportWidth` integer
        - `pdfViewportHeight` integer
        - `pdfExportSettings` object
        - `defaultFilters` Filter[]
          - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
          - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
          - `values` object[] — Filter values
          - `operator` string — Filter operator
          - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
          - `requireValue` boolean — Whether or not filter requires value to be set
          - `enabled` boolean — Whether or not filter is enabled (default is true)
          - `controlType` string — Filter control type
          - `visible` boolean — Whether or not filter is visible (default is true)
          - `hitList` integer — Suggestion values dataset ID
          - `hitListLabel` string — Suggestion label field name of the hit list dataset
          - `hitListValue` string — Suggestion value field name of the hit list dataset
          - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
          - `label` string — Display label for the filter
          - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
          - `description` string — Filter description
          - `dateLimit` string — Filter date limit
          - `dateLimitOptions` string — Filter date limit options (restriction and from token)
          - `displayValues` object[] — Custom display values
          - `plainControlType` string — Control type for plain text field type
          - `dynamic` boolean — Whether or not filter's value is automatically selected
          - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
        - `filterSets` FilterSet[]
          - `createdDate` integer — Created date in milliseconds
          - `lastModDate` integer — Last modified date
          - `id` integer
          - `userId` integer
          - `name` string
          - `accessLevel` integer
          - `userSpecific` boolean
          - `enabled` boolean
          - `color` string
          - `defaultFilters` boolean
          - `locked` boolean
          - `visible` boolean
          - `syncFilters` boolean
          - `expanded` boolean
          - `filters` Filter[]
            - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
            - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
            - `values` object[] — Filter values
              - …
            - `operator` string — Filter operator
            - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
            - `requireValue` boolean — Whether or not filter requires value to be set
            - `enabled` boolean — Whether or not filter is enabled (default is true)
            - `controlType` string — Filter control type
            - `visible` boolean — Whether or not filter is visible (default is true)
            - `hitList` integer — Suggestion values dataset ID
            - `hitListLabel` string — Suggestion label field name of the hit list dataset
            - `hitListValue` string — Suggestion value field name of the hit list dataset
            - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
            - `label` string — Display label for the filter
            - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
            - `description` string — Filter description
            - `dateLimit` string — Filter date limit
            - `dateLimitOptions` string — Filter date limit options (restriction and from token)
            - `displayValues` object[] — Custom display values
              - …
            - `plainControlType` string — Control type for plain text field type
            - `dynamic` boolean — Whether or not filter's value is automatically selected
            - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
          - `transientFilter` boolean
        - `defaultFilterSets` FilterSet[]
          - `createdDate` integer — Created date in milliseconds
          - `lastModDate` integer — Last modified date
          - `id` integer
          - `userId` integer
          - `name` string
          - `accessLevel` integer
          - `userSpecific` boolean
          - `enabled` boolean
          - `color` string
          - `defaultFilters` boolean
          - `locked` boolean
          - `visible` boolean
          - `syncFilters` boolean
          - `expanded` boolean
          - `filters` Filter[]
            - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
            - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
            - `values` object[] — Filter values
              - …
            - `operator` string — Filter operator
            - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
            - `requireValue` boolean — Whether or not filter requires value to be set
            - `enabled` boolean — Whether or not filter is enabled (default is true)
            - `controlType` string — Filter control type
            - `visible` boolean — Whether or not filter is visible (default is true)
            - `hitList` integer — Suggestion values dataset ID
            - `hitListLabel` string — Suggestion label field name of the hit list dataset
            - `hitListValue` string — Suggestion value field name of the hit list dataset
            - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
            - `label` string — Display label for the filter
            - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
            - `description` string — Filter description
            - `dateLimit` string — Filter date limit
            - `dateLimitOptions` string — Filter date limit options (restriction and from token)
            - `displayValues` object[] — Custom display values
              - …
            - `plainControlType` string — Control type for plain text field type
            - `dynamic` boolean — Whether or not filter's value is automatically selected
            - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
          - `transientFilter` boolean
        - `view` object
        - `dashboardGroupingList` integer[]
        - `dashboardGroupingMap` array[]
          - object[]
  - `repeatableWidget` boolean
  - `drilldownFilters` Filter[]
    - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
    - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
    - `values` object[] — Filter values
    - `operator` string — Filter operator
    - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
    - `requireValue` boolean — Whether or not filter requires value to be set
    - `enabled` boolean — Whether or not filter is enabled (default is true)
    - `controlType` string — Filter control type
    - `visible` boolean — Whether or not filter is visible (default is true)
    - `hitList` integer — Suggestion values dataset ID
    - `hitListLabel` string — Suggestion label field name of the hit list dataset
    - `hitListValue` string — Suggestion value field name of the hit list dataset
    - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
    - `label` string — Display label for the filter
    - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
    - `description` string — Filter description
    - `dateLimit` string — Filter date limit
    - `dateLimitOptions` string — Filter date limit options (restriction and from token)
    - `displayValues` object[] — Custom display values
    - `plainControlType` string — Control type for plain text field type
    - `dynamic` boolean — Whether or not filter's value is automatically selected
    - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
  - `displayableFilters` Filter[]
    - `fieldName` string, required — Filter field name. Either fieldName or fieldNames has to be not empty
    - `fieldNames` string[], required — Filter field names in case of tree filter. Either fieldName or fieldNames has to be not empty
    - `values` object[] — Filter values
    - `operator` string — Filter operator
    - `locked` boolean — Whether or not filter is locked (ie: not modifiable)
    - `requireValue` boolean — Whether or not filter requires value to be set
    - `enabled` boolean — Whether or not filter is enabled (default is true)
    - `controlType` string — Filter control type
    - `visible` boolean — Whether or not filter is visible (default is true)
    - `hitList` integer — Suggestion values dataset ID
    - `hitListLabel` string — Suggestion label field name of the hit list dataset
    - `hitListValue` string — Suggestion value field name of the hit list dataset
    - `filteringResult` boolean — Whether the filter should be applied before (false) or after (true) the widget data has been processed
    - `label` string — Display label for the filter
    - `or` boolean — Whether this filter is OR'd with the previous filter (for SQL parsing)
    - `description` string — Filter description
    - `dateLimit` string — Filter date limit
    - `dateLimitOptions` string — Filter date limit options (restriction and from token)
    - `displayValues` object[] — Custom display values
    - `plainControlType` string — Control type for plain text field type
    - `dynamic` boolean — Whether or not filter's value is automatically selected
    - `inclusiveTime` boolean — Whether time range filter is inclusive (includes exact start/end times, where start time is for Start Date and end time for End Date. UI tooltip: When checked, creates a single continuous time period from Start Date/Time to End Date/Time. When unchecked, applies the time range to each day separately (e.g., 9:00-17:00 every day within the date range).)
  - `repeatableWidgetFeatureEnabled` boolean
  - `dataDisplayTypes` object
  - `dbFields` string[]
  - `ignoreVals` string[]
  - `widgetTypeStr` string
  - `filterFieldDataTypesIncludingNested` object
  - `filteringResultFields` object
  - `filterFieldDataTypes` object
  - `ntzColumns` string[]
  - `gridBean` GridBean
    - `jsonRows` object[]
    - `jsonCols` object[]
    - `colTypes` object
    - `existingId` boolean
    - `containsGeoData` string
  - `live` boolean
  - `fields` string[]

## Other responses

- `400` — Bad request
- `401` — User is not authenticated
- `403` — User is not allowed to access this resource
- `500` — Error during processing

---

[API](https://skmtc.net/knowi/apis/user-management-api.md) · [All operations](https://skmtc.net/knowi/apis/user-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/knowi/user-management-api/revisions/6e6982573ba6/schema)