AFM
attributesobject[] · requiredAttributes to be used in the computation.
filtersobject[] · requiredVarious filter types to filter the execution result.
measuresobject[] · requiredMetrics to be computed.
auxMeasuresobject[]Metrics to be referenced from other AFM objects (e.g. filters) but not included in the result.
AbstractMeasureValueFilter
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: comparisonMeasureValueFilter | |
| type = object · requires: rangeMeasureValueFilter | |
| type = object · requires: rankingFilter |
Filter the result by comparing specified metric to given constant value, using given comparison operator.
comparisonMeasureValueFilterobject · required
ActiveObjectIdentification
idstring · requiredObject ID.
typestring · requiredObject type, e.g. dashboard.
workspaceIdstring · requiredWorkspace ID.
AdHocAutomation
alertobjectanalyticalDashboardobjectAn analytical dashboard identifier.
dashboardTabularExportsobject[] · uniquedescriptionstring · maxLength: 255detailsobject · maxLength: 10000Additional details to be included in the automated message.
externalRecipientsobject[] · uniqueExternal recipients of the automation action results.
imageExportsobject[] · uniquemetadataobject | null · maxLength: 250000Additional information for the automation.
notificationChannelobjectA notification channel identifier.
rawExportsobject[] · uniquerecipientsobject[] · uniqueslidesExportsobject[] · uniquetabularExportsobject[] · uniquetagsstring[] · uniqueA list of tags.
Example: ["Revenue","Sales"]titlestring · maxLength: 255visualExportsobject[] · unique
AfmExecution
executionobject · requiredTop level executable entity. Combination of [A]ttributes, [F]ilters & [M]etrics.
resultSpecobject · requiredSpecifies how the result data will be formatted (
dimensions) and which additional data shall be computed (totals).
settingsobjectVarious settings affecting the process of AFM execution or its result
AfmIdentifier
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: identifier | |
| type = object · requires: localIdentifier |
ObjectIdentifier with `identifier` wrapper. This serves to distinguish MD object identifiers in AFM request from local identifiers.
identifierobject · required
AfmLocalIdentifier
localIdentifierstring · pattern:^[.a-zA-Z0-9_-]+$· requiredExample: sampleAutoGenerated0123_ID
AfmValidDescendantsQuery
attributesobject[] · requiredList of identifiers of the attributes to get the valid descendants for.
AfmValidDescendantsResponse
validDescendantsobject · requiredMap of attribute identifiers to list of valid descendants identifiers.
AfmValidObjectsQuery
afmobject · requiredTop level executable entity. Combination of [A]ttributes, [F]ilters & [M]etrics.
typesstring[] · unique · requiredEnum values:factsattributesmeasuresExample: facts
AlertAfm
filtersobject[] · requiredVarious filter types to filter execution result. For anomaly detection, exactly one dataset is specified in the condition. The AFM may contain multiple date filters for different datasets, but only the date filter matching the dataset from the condition is used for anomaly detection.
measuresobject[] · min: 1 · max: 2 · requiredMetrics to be computed. One metric if the alert condition is evaluated to a scalar. Two metrics when they should be evaluated to each other.
attributesobject[] · max: 1Attributes to be used in the computation.
auxMeasuresobject[]Metrics to be referenced from other AFM objects (e.g. filters) but not included in the result.
AlertCondition
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: comparison | |
| type = object · requires: range | |
| type = object · requires: relative | |
| type = object · requires: anomaly |
comparisonobject · required
AlertConditionOperand
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: localIdentifier | |
| type = object · requires: value |
localIdentifierstring · requiredLocal identifier of the metric to be compared.
Example: m1
formatstring | null · maxLength: 2048Metric format.
Example: #,##0Default: #,##0.00titlestring | null · maxLength: 255Metric title.
Example: Revenue
AlertDescription
conditionstring · requiredmetricstring · required
attributestringcurrentValuesobject[]errorMessagestringformattedThresholdstringlowerThresholdnumber · doubleremainingAlertEvaluationCountinteger · int32statusstring · enumEnum values:SUCCESSERRORINTERNAL_ERRORTIMEOUTthresholdnumber · doubletotalValueCountinteger · int32traceIdstringtriggeredAtstring · date-timetriggeredCountinteger · int32upperThresholdnumber · double
AmplitudeService
aiProjectApiKeystring · requiredAPI key for AI project - intended for frontend use.
endpointstring · requiredAmplitude endpoint URL.
gdCommonApiKeystring · requiredAPI key for GoodData common project - used by backend.
reportingEndpointstringOptional reporting endpoint for proxying telemetry events.
AnalyticsCatalogCreatedBy
reasoningstring · requiredReasoning for error states
usersobject[] · requiredUsers who created any object in the catalog
AnalyticsCatalogUser
firstnamestring · requiredFirst name of the user who created any objects
lastnamestring · requiredLast name of the user who created any objects
userIdstring · requiredUser ID of the user who created any objects
AnalyzeCsvRequestItem
locationstring · requiredLocation of the CSV file to analyze.
configobjectCSV analysis request config.
AnalyzeCsvRequestItemConfig
delimitersstring[]Possible column delimiters.
headerDetectMaxRowsinteger · int32Maximum number of rows to work with during header detection.
headerRowCountinteger · int32Number of rows to consider as header, if null, header will be detected.
resultRowsinteger · int32Number of rows to return in the flight that represents analysis result. If 0, no rows are returned, if less than 0, all rows that were in the sample are returned.
AnalyzeCsvResponse
columnsobject[] · requiredList of column metadata.
locationstring · requiredLocation of the analyzed file in the source data source.
previewDataarray[] · requiredPreview of the first N rows of the file.
configobjectConfig used to process the CSV file.
AnalyzeCsvResponseColumn
namestring · requiredName of the column as specified in the file (or autogenerated one if the file has no header).
typestring · requiredType of the column (e.g. string, bool, etc.).
detectedDateFormatsstring[]List of date formats that can be used to parse this column as date. Null if there are none.
AnalyzeCsvResponseConfig
convertOptionsobjectOptions for converting CSV files when reading.
parseOptionsobjectOptions for parsing CSV files.
readOptionsobjectOptions for reading CSV files.
AnomalyDetection
datasetobject · requiredReference to the date dataset to which the filter should be applied.
granularitystring · enum · requiredDate granularity for anomaly detection. Only time-based granularities are supported (HOUR, DAY, WEEK, MONTH, QUARTER, YEAR).
Enum values:HOURDAYWEEKMONTHQUARTERYEARmeasureobject · requiredsensitivitystring · enum · requiredSensitivity level for anomaly detection
Enum values:LOWMEDIUMHIGH
AnomalyDetectionResult
anomalyFlag(boolean | null)[] · requiredattributestring[] · requiredvalues(number | null)[] · required
ApiEntitlement
namestring · enum · requiredEnum values:CacheStrategyContractCustomThemingExtraCacheHipaaPdfExportsUiLocalizationTier
expirystring · datevaluestring
ArithmeticMeasure
leftobject · requiredoperatorstring · enum · requiredArithmetic operator. DIFFERENCE - m₁−m₂ - the difference between two metrics. CHANGE - (m₁−m₂)÷m₂ - the relative difference between two metrics.
Enum values:DIFFERENCECHANGErightobject · required
AttributeElements
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: uris | |
| type = object · requires: values |
uris(string | null)[] · requiredList of attribute elements by reference
AttributeExecutionResultHeader
attributeHeaderobject · requiredHeader containing the information related to attributes.
AttributeFilter
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: negativeAttributeFilter | |
| type = object · requires: positiveAttributeFilter |
Filter able to limit element values by label and related selected negated elements.
negativeAttributeFilterobject · required
AttributeFilterElements
values(string | null)[] · unique · requiredSet of label values.
Example: ["value1","value2"]
AttributeFormat
localestring · requiredFormat locale code like 'en-US', 'cs-CZ', etc.
patternstring · requiredICU formatting pattern like 'y', 'dd.MM.y', etc.
timezonestringTimezone for date formatting like 'America/New_York', 'Europe/Prague', etc.
AttributeItem
labelobject · requiredlocalIdentifierstring · pattern:^[.a-zA-Z0-9_-]+$· requiredLocal identifier of the attribute. This can be used to reference the attribute in other parts of the execution definition.
Example: attribute_1
showAllValuesbooleanIndicates whether to show all values of given attribute even if the data bound to those values is not available.
Default: false
AttributeResultHeader
labelValuestring · requiredA value of the current attribute label.
Example: East CoastprimaryLabelValuestring · requiredA value of the primary attribute label.
Example: 1225
AuthUser
displayNamestring · requiredUser description, which will be visible in application.
Example: jeremyemailstring · requiredEmail - used as lookup (must be unique). For PUT method, it must be same as in URL
Example: zeus@example.com
authenticationIdstringField, which should be stored in metadata in authenticationId field. In PUT and POST method it must be not present, or equal to value calculated by backend (e.g. returned from previous GET).
passwordstringUser password. It is not returned by GET method.
AutomationAlert
conditionrequiredexecutionobject · required
triggerstring · enumTrigger behavior for the alert. ALWAYS - alert is triggered every time the condition is met. ONCE - alert is triggered only once when the condition is met.
Enum values:ALWAYSONCEDefault: ALWAYS
AutomationDashboardTabularExport
requestPayloadobject · requiredExport request object describing the export properties for dashboard tabular exports (v2 with dashboardId).
AutomationExternalRecipient
emailstring · email · requiredE-mail address to send notifications from.
AutomationImageExport
requestPayloadobject · requiredExport request object describing the export properties and metadata for image exports.
AutomationRawExport
requestPayloadobject · requiredExport request object describing the export properties and overrides for raw exports.
AutomationSchedule
cronstring · maxLength: 255 · requiredCron expression defining the schedule of the automation. The format is SECOND MINUTE HOUR DAY-OF-MONTH MONTH DAY-OF-WEEK (YEAR). The example expression signifies an action every 30 minutes from 9:00 to 17:00 on workdays.
Example: 0 */30 9-17 ? * MON-FRItimezonestring · maxLength: 255 · requiredTimezone in which the schedule is defined.
Example: Europe/Prague
cronDescriptionstring · readOnlyHuman-readable description of the cron expression.
firstRunstring · date-timeTimestamp of the first scheduled action. If not provided default to the next scheduled time.
Example: 2025-01-01T12:00:00Z
AutomationSlidesExport
requestPayloadobject · requiredExport request object describing the export properties and metadata for slides exports.
AutomationTabularExport
requestPayloadobject · requiredExport request object describing the export properties and overrides for tabular exports.
AutomationVisualExport
requestPayloadobject · requiredExport request object describing the export properties and metadata for dashboard PDF exports.
AvailableAssignees
userGroupsobject[] · requiredList of user groups
usersobject[] · requiredList of users
BoundedFilter
granularitystring · enum · requiredDate granularity specifying particular date attribute in given dimension.
Enum values:MINUTEHOURDAYWEEKMONTHQUARTERYEARMINUTE_OF_HOURExample: DAY
frominteger | null · int32Start of the filtering interval. Specified by number of periods (with respect to given granularity). Typically negative (historical time interval like -2 for '2 days/weeks, ... ago'). If null, then start of the range is unbounded.
Example: -6tointeger | null · int32End of the filtering interval. Specified by number of periods (with respect to given granularity). Value 'O' is representing current time-interval (current day, week, ...). If null, then end of the range is unbounded.
Example: 0
CacheRemovalInterval
fromstring · date-time · requiredStart timestamp of the removal interval.
removedinteger · int64 · requiredBytes removed during this interval.
tostring · date-time · requiredEnd timestamp of the removal interval.
CacheUsageData
organizationCacheUsageobject · requiredData about the whole organization's cache usage.
workspaceCacheUsagesobject · requiredMap of data about the cache usage of the individual workspaces.
ChangeAnalysisParams
analyzedPeriodstring · requiredThe analyzed time period
attributesobject[] · requiredAttributes to analyze for significant changes
dateAttributeobject · requiredfiltersarray · requiredOptional filters to apply
measureobject · requiredMetric is a quantity that is calculated from the data.
measureTitlestring · requiredThe title of the measure being analyzed
referencePeriodstring · requiredThe reference time period
useSmartAttributeSelectionboolean · requiredWhether to use smart attribute selection
ChangeAnalysisRequest
analyzedPeriodstring · requiredThe analyzed time period (e.g., '2025-02')
dateAttributeobject · requiredmeasureobject · requiredMetric is a quantity that is calculated from the data.
referencePeriodstring · requiredThe reference time period (e.g., '2025-01')
attributesobject[]Attributes to analyze for significant changes. If empty, valid attributes will be automatically discovered.
auxMeasuresobject[]Auxiliary measures
filtersarrayOptional filters to apply.
useSmartAttributeSelectionbooleanWhether to use smart attribute selection (LLM-based) instead of discovering all valid attributes. If true, GenAI will intelligently select the most relevant attributes for change analysis. If false or not set, all valid attributes will be discovered using Calcique. Smart attribute selection applies only when no attributes are provided.
Default: false
ChangeAnalysisResult
dataobject[] · requiredThe change analysis result data containing significant changes.
ChatHistoryInteraction
chatHistoryInteractionIdstring · requiredChat History interaction ID. Unique ID for each interaction.
interactionFinishedboolean · requiredHas the interaction already finished? Can be used for polling when interaction is in progress.
questionstring · maxLength: 2000 · requiredUser question
routingobject · requiredQuestion -> Use Case routing. May contain final answer is a special use case is not required.
changeAnalysisParamsobjectChange analysis specification.
createdVisualizationsobjectVisualization definitions created by AI.
errorResponsestringError response in anything fails.
foundObjectsobjectList of objects found by similarity search and post-processed by LLM.
reasoningobjectReasoning wrapper containing steps taken during request handling.
semanticSearchobjecttextResponsestringText response for general questions.
threadIdSuffixstringChat History thread suffix appended to ID generated by backend. Enables more chat windows.
userFeedbackstring · enumUser feedback.
Enum values:POSITIVENEGATIVENONE
ChatHistoryRequest
chatHistoryInteractionIdstringReturn chat history records only after this interaction ID. If empty, complete chat history is returned.
resetbooleanUser feedback.
responseStatestring · enumResponse state indicating the outcome of the AI interaction.
Enum values:SUCCESSFULUNEXPECTED_ERRORNOT_FOUND_ATTRIBUTESTOO_MANY_DATA_POINTSNO_DATANO_RESULTSOUT_OF_TOPICsavedVisualizationobjectCreated and saved visualization IDs.
threadIdSuffixstringChat History thread suffix appended to ID generated by backend. Enables more chat windows.
userFeedbackstring · enumUser feedback.
Enum values:POSITIVENEGATIVENONEuserTextFeedbackstringUser text feedback for the interaction.
ChatHistoryResult
interactionsobject[] · requiredList of chat history interactions.
threadIdstring · requiredThe conversation thread ID.
ChatRequest
questionstring · maxLength: 2000 · requiredUser question
includeHiddenbooleanIf true, includes hidden objects in search and visualization building. If false (default), excludes objects where isHidden=true.
Default: falselimitCreateinteger · int32Maximum number of created results.
Default: 3limitCreateContextinteger · int32Maximum number of relevant objects included into context for LLM (for each object type).
Default: 10limitSearchinteger · int32Maximum number of search results.
Default: 5objectTypesstring[]List of object types to filter the search and visualization building. If empty or null, all object types are considered.
Enum values:attributemetricfactlabeldatedatasetvisualizationdashboardrelevantScoreThresholdnumber · doubleScore, above which we return found objects. Below this score objects are not relevant.
Default: 0.45searchScoreThresholdnumber · doubleScore, above which we return found object(s) and don't call LLM to create new objects.
Default: 0.9threadIdSuffixstringChat History thread suffix appended to ID generated by backend. Enables more chat windows.
titleToDescriptorRationumber · doubleTemporary for experiments. Ratio of title score to descriptor score.
Default: 0.7userContextobjectUser context, which can affect the behavior of the underlying AI features.
ChatResult
changeAnalysisParamsobjectChange analysis specification.
chatHistoryInteractionIdstringChat History interaction ID. Unique ID for each interaction.
createdVisualizationsobjectVisualization definitions created by AI.
errorResponsestringError response in anything fails.
foundObjectsobjectList of objects found by similarity search and post-processed by LLM.
reasoningobjectReasoning wrapper containing steps taken during request handling.
routingobjectQuestion -> Use Case routing. May contain final answer is a special use case is not required.
semanticSearchobjecttextResponsestringText response for general questions.
threadIdSuffixstringChat History thread suffix appended to ID generated by backend. Enables more chat windows.
ChatUsageResponse
interactionCountinteger · int32 · requiredNumber of interactions in the time window
interactionLimitinteger · int32 · requiredMaximum number of interactions in the time window any user can do in the workspace
timeWindowHoursinteger · int32 · requiredTime window in hours
ClusteringRequest
numberOfClustersinteger · int32 · min: 1 · requiredNumber of clusters to create
thresholdnumber · doubleThreshold used for algorithm
Default: 0.03
ClusteringResult
attributeobject[] · requiredclusters(integer | null)[] · requiredxcoordnumber[] · requiredycoordnumber[] · required
xCoord(number | null)[] · writeOnlyyCoord(number | null)[] · writeOnly
ColumnOverride
namestring · requiredColumn name.
Example: column_name
labelTargetColumnstringSpecifies the attribute's column to which this label is associated.
Example: userslabelTypestring · enumLabel type for the target attribute.
Enum values:TEXTHYPERLINKGEOGEO_LONGITUDEGEO_LATITUDEGEO_AREAIMAGEExample: HYPERLINKldmTypeOverridestring · enumLogical Data Model type for the column.
Enum values:FACTLABELExample: FACT
ColumnStatistic
typestring · enum · requiredEnum values:COUNTCOUNT_NULLCOUNT_UNIQUEAVGSTDDEVMINMAXPERCENTILE_25
valuestring
ColumnStatisticsRequest
columnNamestring · requiredfromrequired
frequencyobjecthistogramobjectstatisticsstring[] · uniqueEnum values:COUNTCOUNT_NULLCOUNT_UNIQUEAVGSTDDEVMINMAXPERCENTILE_25
ColumnWarning
messagestring · requiredWarning message related to the column.
namestring · requiredColumn name.
Comparison
leftobject · requiredoperatorstring · enum · requiredEnum values:GREATER_THANGREATER_THAN_OR_EQUAL_TOLESS_THANLESS_THAN_OR_EQUAL_TOEQUAL_TONOT_EQUAL_TOrightobject · requiredOperand of the alert condition.
CreatedVisualization
dimensionalityobject[] · requiredList of attributes representing the dimensionality of the new visualization
filtersarray · requiredList of filters to be applied to the new visualization
idstring · requiredProposed ID of the new visualization
Example: revenue_by_countrymetricsobject[] · requiredList of metrics to be used in the new visualization
suggestionsobject[] · requiredSuggestions for next steps
titlestring · requiredProposed title of the new visualization
Example: Revenue by CountryvisualizationTypestring · enum · requiredVisualization type requested in question
Enum values:TABLEHEADLINEBARLINEPIECOLUMNExample: TABLE
savedVisualizationIdstringSaved visualization ID.
CreatedVisualizations
objectsobject[] · requiredList of created visualization objects
reasoningstring · requiredDEPRECATED: Use top-level reasoning.steps instead. Reasoning from LLM. Description of how and why the answer was generated.
suggestionsobject[] · requiredList of suggestions for next steps. Filled when no visualization was created, suggests alternatives.
CsvConvertOptions
autoDictEncodebooleanWhether to try to automatically dict-encode string / binary data.
autoDictMaxCardinalityinteger · int32The maximum dictionary cardinality for autoDictEncode.
checkUtf8booleanWhether to check UTF8 validity of string columns.
columnTypesobject[]Information about the column types in the table.
decimalPointstringThe character used as decimal point in floating-point and decimal data.
falseValuesstring[]Sequence of strings that denote false Booleans in the data.
includeColumnsstring[]The names of columns to include in the Table. If empty, the Table will include all columns from the CSV file. If not empty, only these columns will be included, in this order.
includeMissingColumnsbooleanIf false, columns in includeColumns but not in the CSV file will error out.
nullValuesstring[]Sequence of strings that denote nulls in the data.
quotedStringsCanBeNullbooleanWhether quoted values can be null.
stringsCanBeNullbooleanWhether string / binary columns can have null values.
timestampParsersstring[]Sequence of strptime()-compatible format strings, tried in order when attempting to infer or convert timestamp values.
trueValuesstring[]Sequence of strings that denote true Booleans in the data.
CsvConvertOptionsColumnType
namestringThe column name.
nullablebooleanWhether the data in the given column can be null.
typestringThe column type.
CsvManifestBody
column_date_formatsobjectMap of column names to date formats to use when parsing them as dates.
convertobjectOptions for converting CSV files when reading.
parseobjectOptions for parsing CSV files.
readobjectOptions for reading CSV files.
read_methodstringMethod used to read the CSV file.
CsvParseOptions
delimiterstringThe character delimiting individual cells in the CSV data.
doubleQuotebooleanWhether two quotes in a quoted CSV value denote a single quote in the data.
escapeCharobjectThe character used optionally for escaping special characters or false to disable escaping.
ignoreEmptyLinesbooleanWhether empty lines are ignored in CSV input.
newlinesInValuesbooleanWhether newline characters are allowed in CSV values.
quoteCharobjectThe character used optionally for quoting CSV values or false to disable quoting.
CsvReadOptions
autoGenerateColumnNamesbooleanWhether to autogenerate column names if columnNames is empty.
blockSizeinteger · int32How many bytes to process at a time from the input stream.
columnNamesstring[]The column names of the target table.
encodingstringThe character encoding of the CSV data.
skipRowsinteger · int32The number of rows to skip before the column names (if any) and the CSV data.
skipRowsAfterNamesinteger · int32The number of rows to skip after the column names.
useThreadsbooleanWhether to use multiple threads to accelerate reading.
CustomOverride
labelsobjectMap of CustomLabels with keys used as placeholders in document.
metricsobjectMap of CustomMetrics with keys used as placeholders in document.
DashboardExportSettings
exportInfobooleanIf true, the export will contain the information about the export – exported date, dashboard filters, etc.
Example: trueDefault: falsemergeHeadersbooleanMerge equal headers in neighbouring cells. Used for [XLSX] format only.
Example: trueDefault: falsepageOrientationstring · enumSet page orientation. (PDF)
Enum values:PORTRAITLANDSCAPEDefault: PORTRAITpageSizestring · enumSet page size. (PDF)
Enum values:A3A4LETTERDefault: A4
DashboardFilter
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: attributeFilter | |
| type = object · requires: dateFilter |
attributeFilterobject · required
DashboardPermissions
rulesobject[] · requiredList of rules
userGroupsobject[] · requiredList of user groups
usersobject[] · requiredList of users
DashboardTabularExportRequest
fileNamestring · requiredFilename of downloaded file without extension.
Example: resultformatstring · enum · requiredRequested tabular export type.
Enum values:XLSXPDFExample: XLSX
dashboardFiltersOverrideobject[]List of filters that will be used instead of the default dashboard filters.
dashboardTabsFiltersOverridesobjectMap of tab-specific filter overrides. Key is tabId, value is list of filters for that tab.
settingsobjectAdditional settings.
widgetIdsstring[] · maxItems: 1 · uniqueList of widget identifiers to be exported. Note that only one widget is currently supported.
DashboardTabularExportRequestV2
dashboardIdstring · requiredDashboard identifier
Example: 761cd28b-3f57-4ac9-bbdc-1c552cc0d1d0fileNamestring · requiredFilename of downloaded file without extension.
Example: resultformatstring · enum · requiredRequested tabular export type.
Enum values:XLSXPDFExample: XLSX
dashboardFiltersOverrideobject[]List of filters that will be used instead of the default dashboard filters.
dashboardTabsFiltersOverridesobjectMap of tab-specific filter overrides. Key is tabId, value is list of filters for that tab.
settingsobjectAdditional settings.
widgetIdsstring[] · maxItems: 1 · uniqueList of widget identifiers to be exported. Note that only one widget is currently supported.
DataColumnLocator
propertiesobject · requiredMapping from dimension items (either 'localIdentifier' from 'AttributeItem', or "measureGroup") to their respective values. This effectively specifies the path (location) of the data column used for sorting. Therefore values for all dimension items must be specified.
Example: {"measureGroup":"m1","status":"lost"}
DataColumnLocators
propertiesobjectMapping from dimensions to data column locators.
Example: {"dim2":{"measureGroup":"m1","status":"lost"}}
DataSourcePermissionAssignment
assigneeIdentifierobject · requiredIdentifier of a user or user-group.
permissionsstring[] · requiredEnum values:MANAGEUSE
DataSourceTableIdentifier
dataSourceIdstring · maxLength: 255 · requiredData source ID.
Example: my-postgresidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredID of table.
Example: customerstypestring · enum · requiredData source entity type.
Enum values:dataSourceExample: dataSource
patharray | nullPath to table.
Example: ["table_schema","table_name"]
DatasetWorkspaceDataFilterIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredWorkspace Data Filters ID.
Example: country_idtypestring · enum · requiredFilter type.
Enum values:workspaceDataFilterExample: workspaceDataFilter
DateFilter
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: absoluteDateFilter | |
| type = object · requires: relativeDateFilter |
A datetime filter specifying exact from and to values.
absoluteDateFilterobject · required
DateRelativeFilter
frominteger · int32 · requiredgranularitystring · enum · requiredEnum values:MINUTEHOURDAYWEEKMONTHQUARTERYEARMINUTE_OF_HOURtointeger · int32 · requiredusingstring · required
DeclarativeAggregatedFact
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredFact ID.
Example: fact.customer_order_countsourceColumnstring · maxLength: 255 · requiredA name of the source column in the table.
Example: customer_order_countsourceFactReferenceobject · requiredAggregated awareness source fact reference.
descriptionstring · maxLength: 10000Fact description.
Example: A number of orders created by the customer - including all orders, even the non-delivered ones.sourceColumnDataTypestring · enum · maxLength: 255A type of the source column
Enum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEANExample: NUMERICtagsstring[] · uniqueA list of tags.
Example: ["Customers"]
DeclarativeAnalyticalDashboard
contentobject | null · maxLength: 15000 · requiredFree-form JSON object
Example: {}idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAnalytical dashboard ID.
Example: revenues-analysistitlestring · maxLength: 255 · requiredAnalytical dashboard title.
Example: Revenues analysis
createdAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the entity creation.
Example: 2023-07-20 12:30createdByobjectA user identifier.
Example: {"id":"example123","type":"user"}descriptionstring · maxLength: 10000Analytical dashboard description.
Example: Period to period comparison of revenues in main sectors.modifiedAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the last entity modification.
Example: 2023-07-20 12:30modifiedByobjectA user identifier.
Example: {"id":"example123","type":"user"}permissionsarrayA list of permissions.
tagsstring[] · uniqueA list of tags.
Example: ["Revenues"]
DeclarativeAnalyticalDashboardExtension
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAnalytical dashboard ID.
Example: revenues-analysispermissionsarray · requiredA list of permissions.
DeclarativeAnalyticalDashboardIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredIdentifier of the analytical dashboard.
Example: dashboard123typestring · enum · requiredA type.
Enum values:analyticalDashboardExample: analyticalDashboard
DeclarativeAnalyticalDashboardPermissionAssignment
namestring · enum · requiredPermission name.
Enum values:EDITSHAREVIEW
DeclarativeAnalyticalDashboardPermissionForAssignee
namestring · enum · requiredPermission name.
Enum values:EDITSHAREVIEWassigneeobject · requiredIdentifier of a user or user-group.
DeclarativeAnalyticalDashboardPermissionForAssigneeRule
namestring · enum · requiredPermission name.
Enum values:EDITSHAREVIEWassigneeRuleobject · requiredIdentifier of an assignee rule.
DeclarativeAnalyticsLayer
analyticalDashboardExtensionsobject[]A list of dashboard permissions assigned to a related dashboard.
analyticalDashboardsobject[]A list of analytical dashboards available in the model.
attributeHierarchiesobject[]A list of attribute hierarchies.
dashboardPluginsobject[]A list of dashboard plugins available in the model.
exportDefinitionsobject[]A list of export definitions.
filterContextsobject[]A list of filter contexts available in the model.
metricsobject[]A list of metrics available in the model.
visualizationObjectsobject[]A list of visualization objects available in the model.
DeclarativeAttribute
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAttribute ID.
Example: attr.customers.customer_namelabelsobject[] · requiredAn array of attribute labels.
sourceColumnstring · maxLength: 255 · requiredA name of the source column that is the primary label
Example: customer_nametitlestring · maxLength: 255 · requiredAttribute title.
Example: Customer Name
defaultViewobjectA label identifier.
descriptionstring · maxLength: 10000Attribute description.
Example: Customer name including first and last name.isHiddenbooleanIf true, this attribute is hidden from AI search results.
Example: falselocalestringDefault locale for primary label.
Example: en-USsortColumnstring · maxLength: 255Attribute sort column.
Example: customer_namesortDirectionstring · enumAttribute sort direction.
Enum values:ASCDESCExample: "ASC" | "DESC"sourceColumnDataTypestring · enum · maxLength: 255A type of the source column
Enum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEANExample: STRINGtagsstring[] · uniqueA list of tags.
Example: ["Customers"]
DeclarativeAttributeHierarchy
contentobject | null · maxLength: 15000 · requiredFree-form JSON object
Example: {}idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAttribute hierarchy object ID.
Example: hierarchy-1titlestring · maxLength: 255 · requiredAttribute hierarchy object title.
Example: Count of goods
createdAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the entity creation.
Example: ["2023-07-20 12:30"]createdByobjectA user identifier.
Example: {"id":"example123","type":"user"}descriptionstring · maxLength: 10000Attribute hierarchy object description.
Example: Simple number for total goods in current production.modifiedAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the last entity modification.
Example: ["2023-07-20 12:30"]modifiedByobjectA user identifier.
Example: {"id":"example123","type":"user"}tagsstring[] · uniqueA list of tags.
Example: ["Revenues"]
DeclarativeAutomation
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· required
alertobjectanalyticalDashboardobjectAn analytical dashboard identifier.
createdAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the entity creation.
Example: 2023-07-20 12:30createdByobjectA user identifier.
Example: {"id":"example123","type":"user"}dashboardTabularExportsobject[] · uniquedescriptionstring · maxLength: 255detailsobject · maxLength: 10000TODO
evaluationModestring · enumSpecify automation evaluation mode.
Enum values:SHAREDPER_RECIPIENTDefault: PER_RECIPIENTexportDefinitionsobject[] · uniqueexternalRecipientsobject[] · uniqueExternal recipients of the automation action results.
imageExportsobject[] · uniquemetadataobject | null · maxLength: 250000Additional information for the automation.
modifiedAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the last entity modification.
Example: 2023-07-20 12:30modifiedByobjectA user identifier.
Example: {"id":"example123","type":"user"}notificationChannelobjectA notification channel identifier.
rawExportsobject[] · uniquerecipientsobject[] · uniquescheduleobjectslidesExportsobject[] · uniquestatestring · enumCurrent state of the automation.
Enum values:ACTIVEPAUSEDDefault: ACTIVEtabularExportsobject[] · uniquetagsstring[] · uniquetitlestring · maxLength: 255visualExportsobject[] · unique
DeclarativeColorPalette
contentobject | null · maxLength: 15000 · requiredFree-form JSON object
Example: {}idstring · requirednamestring · maxLength: 255 · required
DeclarativeColumn
dataTypestring · enum · requiredColumn type
Enum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEANExample: INTnamestring · maxLength: 255 · pattern:^[^ ]*$· requiredColumn name
Example: customer_id
descriptionstring · maxLength: 10000Column description/comment from database
Example: Customer unique identifierisPrimaryKeybooleanIs column part of primary key?
referencedTableColumnstring · maxLength: 255Referenced table (Foreign key)
Example: customer_idreferencedTableIdstring · maxLength: 255Referenced table (Foreign key)
Example: customers
DeclarativeCustomApplicationSetting
applicationNamestring · maxLength: 255 · requiredThe application id
Example: Modelercontentobject | null · maxLength: 15000 · requiredFree-form JSON object
Example: {}idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredCustom Application Setting ID.
Example: modeler.demo
DeclarativeDashboardPlugin
contentobject | null · maxLength: 15000 · requiredFree-form JSON object
Example: {}idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredDashboard plugin object ID.
Example: dashboard-plugin-1titlestring · maxLength: 255 · requiredDashboard plugin object title.
Example: 3D map renderer
createdAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the entity creation.
Example: ["2023-07-20 12:30"]createdByobjectA user identifier.
Example: {"id":"example123","type":"user"}descriptionstring · maxLength: 10000Dashboard plugin description.
Example: Three dimensional view of data.modifiedAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the last entity modification.
Example: ["2023-07-20 12:30"]modifiedByobjectA user identifier.
Example: {"id":"example123","type":"user"}tagsstring[] · uniqueA list of tags.
Example: ["Revenues"]
DeclarativeDataSource
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredData source ID.
Example: pg_local_docker-demonamestring · maxLength: 255 · requiredName of the data source.
Example: postgres demoschemastring · maxLength: 255 · requiredA scheme/database with the data.
Example: demotypestring · enum · requiredType of database.
Enum values:POSTGRESQLREDSHIFTVERTICASNOWFLAKEADSBIGQUERYMSSQLPRESTOExample: POSTGRESQL
alternativeDataSourceIdstring | null · pattern:^(?!\.)[.A-Za-z0-9_-…Alternative data source ID. It is a weak reference meaning data source does not have to exist. All the entities (e.g. tables) from the data source must be available also in the alternative data source. It must be present in the same organization as the data source.
Example: pg_local_docker-demo2authenticationTypestring | null · enumType of authentication used to connect to the database.
Enum values:USERNAME_PASSWORDTOKENKEY_PAIRCLIENT_SECRETACCESS_TOKENcacheStrategystring · enumDetermines how the results coming from a particular datasource should be cached.
- ALWAYS: The results from the datasource should be cached normally (the default).
- NEVER: The results from the datasource should never be cached.
Enum values:ALWAYSNEVERclientIdstring · maxLength: 255Id of client with permission to connect to the data source.
Example: client1234clientSecretstring · maxLength: 255The client secret to use to connect to the database providing the data for the data source.
decodedParametersobject[]parametersobject[]passwordstring · maxLength: 255Password for the data-source user, property is never returned back.
Example: *****permissionsobject[]privateKeystring | null · maxLength: 15000The private key to use to connect to the database providing the data for the data source.
privateKeyPassphrasestring | null · maxLength: 255The passphrase used to encrypt the private key.
tokenstring · maxLength: 10000Token as an alternative to username and password.
Example: Bigquery service account JSON. Encode it using base64!urlstring · maxLength: 255An connection string relevant to type of database.
Example: jdbc:postgresql://postgres:5432/gooddatausernamestring · maxLength: 255User with permission connect the data source/database.
Example: demo
DeclarativeDataSourcePermission
assigneeobject · requiredIdentifier of a user or user-group.
namestring · enum · requiredPermission name.
Enum values:MANAGEUSE
DeclarativeDataset
grainobject[] · requiredAn array of grain identifiers.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredThe Dataset ID. This ID is further used to refer to this instance of dataset.
Example: customersreferencesobject[] · requiredAn array of references.
titlestring · maxLength: 255 · requiredA dataset title.
Example: Customers
aggregatedFactsobject[]An array of aggregated facts.
attributesobject[]An array of attributes.
dataSourceTableIdobjectAn id of the table. Including ID of data source.
Example: {"dataSourceId":"my-postgres","id":"customers","type":"DATA_SOURCE"}descriptionstring · maxLength: 10000A dataset description.
Example: The customers of ours.factsobject[]An array of facts.
precedenceinteger · int32 · min: 0Precedence used in aggregate awareness.
Example: 0sqlobjectSQL defining this dataset.
Example: {"dataSourceId":"my-postgres","statement":"SELECT * FROM some_table"}tagsstring[] · uniqueA list of tags.
Example: ["Customers"]workspaceDataFilterColumnsobject[]An array of columns which are available for match to implicit workspace data filters.
workspaceDataFilterReferencesobject[]An array of explicit workspace data filters.
DeclarativeDatasetExtension
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredThe Dataset ID. This ID is further used to refer to this instance of dataset.
Example: customers
workspaceDataFilterReferencesobject[]An array of explicit workspace data filters.
DeclarativeDatasetSql
dataSourceIdstring · requiredData source ID.
Example: my-postgresstatementstring · requiredSQL statement.
Example: SELECT * FROM some_table
DeclarativeDateDataset
granularitiesstring[] · requiredAn array of date granularities. All listed granularities will be available for date dataset.
Enum values:MINUTEHOURDAYWEEKMONTHQUARTERYEARMINUTE_OF_HOURgranularitiesFormattingobject · requiredA date dataset granularities title formatting rules.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredDate dataset ID.
Example: datetitlestring · maxLength: 255 · requiredDate dataset title.
Example: Date
descriptionstring · maxLength: 10000Date dataset description.
Example: A customer order datetagsstring[] · uniqueA list of tags.
Example: ["Customer dates"]
DeclarativeExportDefinition
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredExport definition id.
Example: export-definition-1titlestring · maxLength: 255 · requiredExport definition object title.
Example: My regular export
createdAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the entity creation.
Example: ["2023-07-20 12:30"]createdByobjectA user identifier.
Example: {"id":"example123","type":"user"}descriptionstring · maxLength: 10000Export definition object description.
Example: Simple number for total goods in current production.modifiedAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the last entity modification.
Example: ["2023-07-20 12:30"]modifiedByobjectA user identifier.
Example: {"id":"example123","type":"user"}requestPayloadtagsstring[] · uniqueA list of tags.
Example: ["Revenues"]
DeclarativeExportDefinitionIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredExport definition identifier.
Example: export123typestring · enum · requiredA type.
Enum values:exportDefinitionExample: exportDefinition
DeclarativeExportTemplate
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredIdentifier of an export template
Example: default-export-templatenamestring · maxLength: 255 · requiredName of an export template.
Example: My default export template
dashboardSlidesTemplateobject | nullTemplate for dashboard slides export. Available variables: {{currentPageNumber}}, {{dashboardDateFilters}}, {{dashboardDescription}}, {{dashboardFilters}}, {{dashboardId}}, {{dashboardName}}, {{dashboardTags}}, {{dashboardUrl}}, {{exportedAt}}, {{exportedBy}}, {{logo}}, {{totalPages}}, {{workspaceId}}, {{workspaceName}}
widgetSlidesTemplateobject | nullTemplate for widget slides export. Available variables: {{currentPageNumber}}, {{dashboardDateFilters}}, {{dashboardDescription}}, {{dashboardFilters}}, {{dashboardId}}, {{dashboardName}}, {{dashboardTags}}, {{dashboardUrl}}, {{exportedAt}}, {{exportedBy}}, {{logo}}, {{totalPages}}, {{workspaceId}}, {{workspaceName}}
DeclarativeFact
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredFact ID.
Example: fact.customer_order_countsourceColumnstring · maxLength: 255 · requiredA name of the source column in the table.
Example: customer_order_counttitlestring · maxLength: 255 · requiredFact title.
Example: Customer order count
descriptionstring · maxLength: 10000Fact description.
Example: A number of orders created by the customer - including all orders, even the non-delivered ones.isHiddenbooleanIf true, this fact is hidden from AI search results.
Example: falsesourceColumnDataTypestring · enum · maxLength: 255A type of the source column
Enum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEANExample: NUMERICtagsstring[] · uniqueA list of tags.
Example: ["Customers"]
DeclarativeFilterContext
contentobject | null · maxLength: 15000 · requiredFree-form JSON object
Example: {}idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredFilter Context ID.
Example: filter-salestitlestring · maxLength: 255 · requiredFilter Context title.
Example: Filter Context for Sales team
descriptionstring · maxLength: 10000Filter Context description.
Example: Filter Context for Sales team.tagsstring[] · uniqueA list of tags.
Example: ["Revenues"]
DeclarativeFilterView
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredFilterView object ID.
Example: filterView-1titlestring · maxLength: 255 · required
analyticalDashboardobjectAn analytical dashboard identifier.
contentobject | null · maxLength: 15000Free-form JSON object
Example: {}descriptionstring · maxLength: 255isDefaultbooleanIndicator whether the filter view should by applied by default.
tagsstring[] · uniqueuserobjectA user identifier.
Example: {"id":"example123","type":"user"}
DeclarativeIdentityProvider
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredFilterView object ID.
Example: filterView-1
customClaimMappingobject · maxLength: 10000Map of custom claim overrides. To be used when your Idp does not provide default claims (sub, email, name, given_name, family_name, urn.gooddata.user_groups [optional]). Define the key pair for the claim you wish to override, where the key is the default name of the attribute and the value is your custom name for the given attribute.
identifiersstring[]List of identifiers for this IdP, where an identifier is a domain name. Users with email addresses belonging to these domains will be authenticated by this IdP.
Example: ["gooddata.com"]idpTypestring · enumType of IdP for management purposes. MANAGED_IDP represents a GoodData managed IdP used in single OIDC setup, which is protected from altering/deletion. FIM_IDP represents a GoodData managed IdP used in federated identity management setup, which is protected from altering/deletion. CUSTOM_IDP represents customer's own IdP, protected from deletion if currently used by org for authentication, deletable otherwise.
Enum values:MANAGED_IDPFIM_IDPDEX_IDPCUSTOM_IDPoauthClientIdstring · maxLength: 255The OAuth client id of your OIDC provider. This field is mandatory for OIDC IdP.
oauthClientSecretstring · maxLength: 255The OAuth client secret of your OIDC provider. This field is mandatory for OIDC IdP.
oauthCustomAuthAttributesobject · maxLength: 10000Map of additional authentication attributes that should be added to the OAuth2 authentication requests, where the key is the name of the attribute and the value is the value of the attribute.
oauthCustomScopesarray | nullList of additional OAuth scopes which may be required by other providers (e.g. Snowflake)
oauthIssuerIdstring · maxLength: 255Any string identifying the OIDC provider. This value is used as suffix for OAuth2 callback (redirect) URL. If not defined, the standard callback URL is used. This value is valid only for external OIDC providers, not for the internal DEX provider.
Example: myOidcProvideroauthIssuerLocationstring · maxLength: 255The location of your OIDC provider. This field is mandatory for OIDC IdP.
oauthSubjectIdClaimstring · maxLength: 255Any string identifying the claim in ID token, that should be used for user identification. The default value is 'sub'.
Example: oidsamlMetadatastring · maxLength: 15000Base64 encoded xml document with SAML metadata. This document is issued by your SAML provider. It includes the issuer's name, expiration information, and keys that can be used to validate the response from the identity provider. This field is mandatory for SAML IdP.
DeclarativeIdentityProviderIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredIdentifier of the identity provider.
Example: gooddata.comtypestring · enum · requiredA type.
Enum values:identityProviderExample: identityProvider
DeclarativeJwk
contentobject · requiredDeclarative specification of the cryptographic key.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredJWK object ID.
Example: jwk-1
DeclarativeJwkSpecification
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: alg, e, kid +3 more |
Declarative specification of the cryptographic key.
algstring · enum · requiredAlgorithm intended for use with the key.
Enum values:RS256RS384RS512Example: RS256estring · requiredparameter contains the exponent value for the RSA public key.
kidstring · maxLength: 255 · pattern:^[^.]· requiredParameter is used to match a specific key.
Example: key.001ktystring · enum · requiredKey type parameter
Enum values:RSAExample: RSAnstring · requiredParameter contains the modulus value for the RSA public key.
usestring · enum · requiredParameter identifies the intended use of the public key.
Enum values:sigExample: sig
x5cstring[]Parameter contains a chain of one or more PKIX certificates.
x5tstringParameter is a base64url-encoded SHA-1 thumbprint of the DER encoding of an X.509 certificate.
DeclarativeLabel
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredLabel ID.
Example: label.customer_namesourceColumnstring · maxLength: 255 · requiredA name of the source column in the table.
Example: customer_nametitlestring · maxLength: 255 · requiredLabel title.
Example: Customer name
descriptionstring · maxLength: 10000Label description.
Example: Customer namegeoAreaConfigobjectConfiguration specific to geo area labels.
isHiddenbooleanDetermines if the label is hidden from AI features.
Example: falselocalestringDefault label locale.
Example: en-USsourceColumnDataTypestring · enum · maxLength: 255A type of the source column
Enum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEANExample: STRINGtagsstring[] · uniqueA list of tags.
Example: ["Customers"]translationsobject[]Other translations.
valueTypestring · enumSpecific type of label
Enum values:TEXTHYPERLINKGEOGEO_LONGITUDEGEO_LATITUDEGEO_AREAIMAGE
DeclarativeLabelTranslation
localestring · requiredTranslation locale.
Example: en-USsourceColumnstring · requiredTranslation source column.
Example: customer_name_en
DeclarativeLdm
datasetExtensionsobject[]An array containing extensions for datasets defined in parent workspaces.
datasetsobject[]An array containing datasets.
dateInstancesobject[]An array containing date-related datasets.
DeclarativeMetric
contentobject | null · maxLength: 15000 · requiredFree-form JSON object
Example: {}idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredMetric ID.
Example: total-salestitlestring · maxLength: 255 · requiredMetric title.
Example: Total sales
createdAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the entity creation.
Example: ["2023-07-20 12:30"]createdByobjectA user identifier.
Example: {"id":"example123","type":"user"}descriptionstring · maxLength: 10000Metric description.
Example: Sales for all the data available.isHiddenbooleanIf true, this metric is hidden from AI search results.
Example: falsemodifiedAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the last entity modification.
Example: ["2023-07-20 12:30"]modifiedByobjectA user identifier.
Example: {"id":"example123","type":"user"}tagsstring[] · uniqueA list of tags.
Example: ["Revenues"]
DeclarativeNotificationChannel
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredIdentifier of a notification channel
Example: notification-channel-1
allowedRecipientsstring · enumAllowed recipients of notifications from this channel. CREATOR - only the creator INTERNAL - all users within the organization EXTERNAL - all recipients including those outside the organization
Enum values:CREATORINTERNALEXTERNALDefault: INTERNALcustomDashboardUrlstring · maxLength: 255Custom dashboard url that is going to be used in the notification. If not specified it is going to be deduced based on the context. Allowed placeholders are: {workspaceId} {dashboardId} {automationId} {asOfDate}
dashboardLinkVisibilitystring · enumDashboard link visibility in notifications. HIDDEN - the link will not be included INTERNAL_ONLY - only internal users will see the link ALL - all users will see the link
Enum values:HIDDENINTERNAL_ONLYALLDefault: INTERNAL_ONLYdescriptionstring · maxLength: 10000Description of a notification channel.
Example: This is a channeldestinationdestinationTypestring | null · enum · readOnlyEnum values:WEBHOOKSMTPDEFAULT_SMTPIN_PLATFORMinPlatformNotificationstring · enumIn-platform notifications configuration. No effect if the destination type is IN_PLATFORM. DISABLED - in-platform notifications are not sent ENABLED - in-platform notifications are sent in addition to the regular notifications
Enum values:DISABLEDENABLEDDefault: DISABLEDnamestring · maxLength: 255Name of a notification channel.
Example: channelnotificationSourcestring · maxLength: 10000Human-readable description of the source of the notification. If specified, this propertywill be included in the notifications to this channel.Allowed placeholders are: {{workspaceId}} {{workspaceName}} {{workspaceDescription}} {{dashboardId}} {{dashboardName}} {{dashboardDescription}}
DeclarativeNotificationChannelIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredNotification channel identifier.
Example: webhook123typestring · enum · requiredA type.
Enum values:notificationChannelExample: notificationChannel
DeclarativeOrganization
organizationobject · requiredInformation available about an organization.
dataSourcesobject[]exportTemplatesobject[]identityProvidersobject[]jwksobject[]notificationChannelsobject[]userGroupsobject[]usersobject[]workspaceDataFiltersobject[]workspacesobject[]
DeclarativeOrganizationInfo
hostnamestring · maxLength: 255 · requiredFormal hostname used in deployment.
Example: alpha.comidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredIdentifier of the organization.
Example: Alpha corporationnamestring · maxLength: 255 · requiredFormal name of the organization.
Example: Alpha corporationpermissionsobject[] · required
allowedOriginsstring[]colorPalettesobject[]A list of color palettes.
cspDirectivesobject[]A list of CSP directives.
earlyAccessValuesstring[] · uniqueEarly access defined on level Organization
identityProviderobjectAn Identity Provider identifier.
settingsobject[]A list of organization settings.
themesobject[]A list of themes.
earlyAccessstring · maxLength: 255 · deprecated · requiredEarly access defined on level Organization
DeclarativeOrganizationPermission
assigneeobject · requiredIdentifier of a user or user-group.
namestring · enum · requiredPermission name.
Enum values:MANAGESELF_CREATE_TOKEN
DeclarativeReference
identifierobject · requiredA reference identifier.
multivalueboolean · requiredThe multi-value flag enables many-to-many cardinality for references.
Example: false
sourcesobject[]An array of source columns for a given reference.
sourceColumnDataTypesstring[] · deprecated · requiredAn array of source column data types for a given reference. Deprecated, use 'sources' instead.
Enum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEANsourceColumnsstring[] · deprecated · requiredAn array of source column names for a given reference. Deprecated, use 'sources' instead.
Example: ["customer_id"]
DeclarativeReferenceSource
columnstring · maxLength: 255 · requiredA name of the source column in the table.
Example: customer_idtargetobject · maxLength: 255 · requiredA grain identifier.
Example: {"id":"customer_id","type":"attribute"}
dataTypestring · enum · maxLength: 255A type of the source column.
Enum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEANExample: STRING
DeclarativeRsaSpecification
algstring · enum · requiredAlgorithm intended for use with the key.
Enum values:RS256RS384RS512Example: RS256estring · requiredparameter contains the exponent value for the RSA public key.
kidstring · maxLength: 255 · pattern:^[^.]· requiredParameter is used to match a specific key.
Example: key.001ktystring · enum · requiredKey type parameter
Enum values:RSAExample: RSAnstring · requiredParameter contains the modulus value for the RSA public key.
usestring · enum · requiredParameter identifies the intended use of the public key.
Enum values:sigExample: sig
x5cstring[]Parameter contains a chain of one or more PKIX certificates.
x5tstringParameter is a base64url-encoded SHA-1 thumbprint of the DER encoding of an X.509 certificate.
DeclarativeSetting
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredSetting ID.
contentobject | null · maxLength: 15000Free-form JSON object
Example: {}typestring · enumType of the setting.
Enum values:TIMEZONEACTIVE_THEMEACTIVE_COLOR_PALETTEACTIVE_LLM_ENDPOINTWHITE_LABELINGLOCALEMETADATA_LOCALEFORMAT_LOCALEExample: TIMEZONE
DeclarativeSingleWorkspacePermission
assigneeobject · requiredIdentifier of a user or user-group.
namestring · enum · requiredPermission name.
Enum values:MANAGEANALYZEEXPORTEXPORT_TABULAREXPORT_PDFCREATE_AUTOMATIONUSE_AI_ASSISTANTCREATE_FILTER_VIEW
DeclarativeSourceFactReference
operationstring · enum · requiredAggregation operation.
Enum values:SUMMINMAXExample: SUMreferenceobject · requiredA fact identifier.
DeclarativeTable
columnsobject[] · requiredAn array of physical columns
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredTable id.
Example: customerspathstring[] · requiredPath to table.
Example: ["table_schema","table_name"]typestring · requiredTable type: TABLE or VIEW.
Example: TABLE
namePrefixstring · maxLength: 255Table or view name prefix used in scan. Will be stripped when generating LDM.
Example: out_gooddata
DeclarativeTheme
contentobject | null · maxLength: 15000 · requiredFree-form JSON object
Example: {}idstring · requirednamestring · maxLength: 255 · required
DeclarativeUser
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredUser identifier.
Example: employee123
authIdstring · maxLength: 255User identification in the authentication manager.
emailstring · maxLength: 255User email address
Example: user@example.comfirstnamestring · maxLength: 255User first name
Example: Johnlastnamestring · maxLength: 255User last name
Example: Wickpermissionsobject[]settingsobject[]A list of user settings.
userGroupsobject[]
DeclarativeUserDataFilter
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredUser Data Filters ID. This ID is further used to refer to this instance.
Example: country_id_settingmaqlstring · maxLength: 10000 · requiredExpression in MAQL specifying the User Data Filter
Example: {label/country} = "USA" AND {label/date.year} = THIS(YEAR)titlestring · maxLength: 255 · requiredUser Data Filters setting title.
Example: Country ID setting
descriptionstring · maxLength: 10000User Data Filters setting description.
Example: ID of country settingtagsstring[] · uniqueA list of tags.
Example: ["Revenues"]userobjectA user identifier.
Example: {"id":"example123","type":"user"}userGroupobjectA user group identifier.
Example: {"id":"admins","type":"userGroup"}
DeclarativeUserGroup
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredUserGroup identifier.
Example: employees.all
namestring · maxLength: 255Name of UserGroup
Example: adminsparentsobject[]permissionsobject[]
DeclarativeUserGroupIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredIdentifier of the user group.
Example: group.adminstypestring · enum · requiredA type.
Enum values:userGroupExample: userGroup
DeclarativeUserGroupPermission
assigneeobject · requiredIdentifier of a user or user-group.
namestring · enum · requiredPermission name.
Enum values:SEE
DeclarativeUserIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredUser identifier.
Example: employee123typestring · enum · requiredA type.
Enum values:userExample: user
DeclarativeUserPermission
assigneeobject · requiredIdentifier of a user or user-group.
namestring · enum · requiredPermission name.
Enum values:SEE
DeclarativeVisualizationObject
contentobject | null · maxLength: 15000 · requiredFree-form JSON object
Example: {}idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredVisualization object ID.
Example: visualization-1titlestring · maxLength: 255 · requiredVisualization object title.
Example: Count of goods
createdAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the entity creation.
Example: ["2023-07-20 12:30"]createdByobjectA user identifier.
Example: {"id":"example123","type":"user"}descriptionstring · maxLength: 10000Visualization object description.
Example: Simple number for total goods in current production.isHiddenbooleanIf true, this visualization object is hidden from AI search results.
Example: falsemodifiedAtstring | null · pattern:[0-9]{4}-[0-9]{2}-[0…Time of the last entity modification.
Example: ["2023-07-20 12:30"]modifiedByobjectA user identifier.
Example: {"id":"example123","type":"user"}tagsstring[] · uniqueA list of tags.
Example: ["Revenues"]
DeclarativeWorkspace
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredIdentifier of a workspace
Example: alpha.salesnamestring · maxLength: 255 · requiredName of a workspace to view.
Example: Alpha Sales
automationsobject[]cacheExtraLimitinteger · int64Extra cache limit allocated to specific workspace. In case there is extra cache budget setup for organization, it can be split between multiple workspaces.
customApplicationSettingsobject[]A list of workspace custom settings.
dataSourceobjectThe data source used for the particular workspace instead of the one defined in the LDM inherited from its parent workspace. Such data source cannot be defined for a single or a top-parent workspace.
descriptionstring · maxLength: 255Description of the workspace
earlyAccessValuesstring[] · uniqueEarly access defined on level Workspace
filterViewsobject[]hierarchyPermissionsobject[]modelobjectA declarative form of a model and analytics for a workspace.
parentobjectA workspace identifier.
Example: { id: demo, type: workspace }permissionsobject[]prefixstring · maxLength: 255 · pattern:^(?!\.)[.A-Za-z0-9_-…Custom prefix of entity identifiers in workspace
settingsobject[]A list of workspace settings.
userDataFiltersobject[]A list of workspace user data filters.
earlyAccessstring · maxLength: 255 · deprecated · requiredEarly access defined on level Workspace
DeclarativeWorkspaceDataFilter
columnNamestring · maxLength: 255 · requiredWorkspace Data Filters column name. Data are filtered using this physical column.
Example: country_ididstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredWorkspace Data Filters ID. This ID is further used to refer to this instance.
Example: country_idtitlestring · maxLength: 255 · requiredWorkspace Data Filters title.
Example: Country IDworkspaceobject · requiredA workspace identifier.
Example: { id: demo, type: workspace }workspaceDataFilterSettingsobject[] · requiredFilter settings specifying values of filters valid for the workspace.
descriptionstring · maxLength: 10000Workspace Data Filters description.
Example: ID of country
DeclarativeWorkspaceDataFilterColumn
dataTypestring · enum · requiredData type of the column
Enum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEANExample: INTnamestring · requiredName of the column
Example: customer_id
DeclarativeWorkspaceDataFilterReferences
filterColumnstring · requiredFilter column name
Example: filter_idfilterColumnDataTypestring · enum · requiredFilter column data type
Enum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEANExample: INTfilterIdobject · requiredIdentifier of a workspace data filter.
DeclarativeWorkspaceDataFilterSetting
filterValuesstring[] · requiredOnly those rows are returned, where columnName from filter matches those values.
Example: ["US"]idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredWorkspace Data Filters ID. This ID is further used to refer to this instance.
Example: country_id_settingtitlestring · maxLength: 255 · requiredWorkspace Data Filters setting title.
Example: Country ID settingworkspaceobject · requiredA workspace identifier.
Example: { id: demo, type: workspace }
descriptionstring · maxLength: 10000Workspace Data Filters setting description.
Example: ID of country setting
DeclarativeWorkspaceHierarchyPermission
assigneeobject · requiredIdentifier of a user or user-group.
namestring · enum · requiredPermission name.
Enum values:MANAGEANALYZEEXPORTEXPORT_TABULAREXPORT_PDFCREATE_AUTOMATIONUSE_AI_ASSISTANTCREATE_FILTER_VIEW
DefaultSmtp
typestring · enum · requiredThe destination type.
Enum values:DEFAULT_SMTP
fromEmailstring · emailE-mail address to send notifications from. Currently this does not have any effect. E-mail 'no-reply@gooddata.com' is used instead.
Default: no-reply@gooddata.comfromEmailNamestringAn optional e-mail name to send notifications from. Currently this does not have any effect. E-mail from name 'GoodData' is used instead.
Default: GoodData
DependentEntitiesNode
idstring · requiredtypestring · enum · requiredEnum values:analyticalDashboardattributeattributeHierarchydashboardPlugindatasetfactlabelmetricExample: metric
titlestring
DependsOn
labelstring · requiredSpecifies on which label the filter depends on.
values(string | null)[] · requiredSpecifies values of the label for element filtering.
complementFilterbooleanInverse filtering mode.
Default: false
DimAttribute
idstring · requiredID of the object
Example: countrytitlestring · requiredTitle of attribute.
typestring · enum · requiredObject type
Enum values:attributeExample: attribute
Dimension
itemIdentifiersstring[] · requiredList of items in current dimension. Can reference 'localIdentifier' from 'AttributeItem', or special pseudo attribute "measureGroup" representing list of metrics.
Example: ["attribute_1","measureGroup"]
localIdentifierstring · pattern:^[.a-zA-Z0-9_-]+$Dimension identification within requests. Other entities can reference this dimension by this value.
Example: firstDimensionsortingobject[]List of sorting rules. From most relevant to least relevant (less relevant rule is applied, when more relevant rule compares items as equal).
Element
primaryTitlestring · requiredTitle of primary label of attribute owning requested label, null if the title is null or the primary label is excluded
titlestring · requiredTitle of requested label.
ElementsRequest
labelstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredRequested label.
Example: label_id
cacheIdstringIf specified, the element data will be taken from the result with the same cacheId if it is available.
complementFilterbooleanInverse filters:
false- return items matchingpatternFilterandexactFiltertrue- return items not matchingpatternFilterandexactFilter
Default: falsedependsOnarrayReturn only items that are not filtered-out by the parent filters.
exactFilter(string | null)[]Return only items, whose
labeltitle exactly matches one offilter.excludePrimaryLabelbooleanExcludes items from the result that differ only by primary label
false- return items with distinct primary labeltrue- return items with distinct requested label
Default: falsefilterByobjectSpecifies what is used for filtering.
patternFilterstringReturn only items, whose
labeltitle case insensitively containsfilteras substring.sortOrderstring · enumSort order of returned items. Items are sorted by
labeltitle. If no sort order is specified then attribute'ssortDirectionis used, which is ASC by defaultEnum values:ASCDESCvalidateBy(object | null)[]Return only items that are computable on metric.
dataSamplingPercentagenumber · float · deprecated · requiredSpecifies percentage of source table data scanned during the computation. This field is deprecated and is no longer used during the elements computation.
Default: 100
ElementsResponse
elementsobject[] · requiredList of returned elements.
pagingobject · requiredCurrent page description.
primaryLabelobject · requiredObject identifier.
cacheIdstringThe client can use this in subsequent requests (like paging or search) to get results from the same point in time as the previous request. This is useful when the underlying data source has caches disabled and the client wants to avoid seeing inconsistent results and to also avoid excessive queries to the database itself.
formatobjectAttribute format describes formatting information to effectively format attribute values when needed.
granularitystring · enumGranularity of requested label in case of date attribute
Enum values:MINUTEHOURDAYWEEKMONTHQUARTERYEARMINUTE_OF_HOUR
EntitlementsRequest
entitlementsNamestring[] · unique · requiredEnum values:CacheStrategyContractCustomThemingExtraCacheHipaaPdfExportsUiLocalizationTier
EntityIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredObject identifier.
typestring · enum · requiredEnum values:analyticalDashboardattributeattributeHierarchydashboardPlugindatasetfactlabelmetricExample: metric
EntitySearchBody
filterstring | nullFiltering parameter in RSQL. See https://github.com/jirutka/rsql-parser. You can specify any object parameter and parameter of related entity (for example title=='Some Title';description=='desc'). Additionally, if the entity relationship represents a polymorphic entity type, it can be casted to its subtypes (for example relatedEntity::subtype.subtypeProperty=='Value 123').
includearray | nullList of related entities to include in the response
metaIncludearray | null · uniqueSet of metadata fields to include in the response
pageobjectPagination information for entity search
sortarray | nullSorting criteria (can specify multiple sort orders)
EntitySearchPage
indexinteger · int32 · min: 0 · requiredZero-based page index
Default: 0sizeinteger · int32 · min: 1 · requiredNumber of items per page
Default: 100
EntitySearchSort
propertystring · requiredProperty name to sort by
directionstring · enumSort direction
Enum values:ASCDESCDefault: ASC
ExecutionResponse
dimensionsobject[] · requiredDimensions of the result
linksobject · requiredLinks to the execution result.
ExecutionResult
dataobject[] · requiredA multi-dimensional array of computed results. The most common one being a 2-dimensional array. The arrays can be composed of Double or null values.
Example: [[1,2.5],[-1.3,3.14]]dimensionHeadersobject[] · requiredAn array containing dimension headers. The size of the array corresponds to the number of dimensions. Their order corresponds to the dimension order in the execution result spec.
grandTotalsobject[] · requiredmetadataobject · requiredAdditional metadata for the particular execution result.
pagingobject · requiredA paging information related to the data presented in the execution result. These paging information are multi-dimensional.
ExecutionResultDataSourceMessage
correlationIdstring · requiredId correlating different pieces of supplementary info together.
sourcestring · requiredInformation about what part of the system created this piece of supplementary info.
typestring · requiredType of the supplementary info instance. There are currently no well-known values for this, but there might be some in the future.
dataobjectData of this particular supplementary info item: a free-form JSON specific to the particular supplementary info item type.
ExecutionResultGrandTotal
dataobject[] · requiredA multi-dimensional array of computed results. The most common one being a 2-dimensional array. The arrays can be composed of Double or null values.
Example: [[1,2.5],[-1.3,3.14]]dimensionHeadersobject[] · requiredContains headers for a subset of
totalDimensionsin which the totals are grand totals.totalDimensionsstring[] · requiredDimensions of the grand totals.
ExecutionResultHeader
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: attributeHeader | |
| type = object · requires: measureHeader | |
| type = object · requires: totalHeader |
attributeHeaderobject · requiredHeader containing the information related to attributes.
ExecutionResultMetadata
dataSourceMessagesobject[] · requiredAdditional information sent by the underlying data source.
ExecutionResultPaging
countinteger[] · requiredA count of the returned results in every dimension.
Example: [2,2]offsetinteger[] · requiredThe offset of the results returned in every dimension.
Example: [0,0]totalinteger[] · requiredA total count of the results in every dimension.
Example: [2,2]
ExecutionSettings
dataSamplingPercentagenumber · floatSpecifies the percentage of rows from fact datasets to use during computation. This feature is available only for workspaces that use a Vertica Data Source without table views.
timestampstring · date-timeSpecifies the timestamp of the execution from which relative filters are resolved. If not set, the current time is used.
ExportRequest
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: dashboardId, fileName | |
| type = object · requires: fileName, format |
Export request object describing the export properties and metadata for dashboard PDF exports.
dashboardIdstring · requiredDashboard identifier
Example: 761cd28b-3f57-4ac9-bbdc-1c552cc0d1d0fileNamestring · requiredFile name to be used for retrieving the pdf document.
Example: filename
metadataobjectMetadata definition in free-form JSON format.
Example: {}
ExportResult
exportIdstring · requiredfileNamestring · requiredstatusstring · enum · requiredEnum values:SUCCESSERRORINTERNAL_ERRORTIMEOUT
errorMessagestringexpiresAtstring · date-timefileSizeinteger · int64fileUristringtraceIdstringtriggeredAtstring · date-time
FactIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredFact ID.
Example: fact_idtypestring · enum · requiredA type of the fact.
Enum values:factExample: fact
File
anyobject[]canResegmentstring · enumEnum values:YESNOidstringnotesobjectoriginalstringotherAttributesobjectskeletonobjectspacestringsrcDirstring · enumEnum values:LTRRTLAUTOtranslatestring · enumEnum values:YESNOtrgDirstring · enumEnum values:LTRRTLAUTOunitOrGroupobject[]
FilterBy
labelTypestring · enumSpecifies which label is used for filtering - primary or requested.
Enum values:PRIMARYREQUESTEDDefault: REQUESTED
FilterDefinition
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: inline | |
| type = object · requires: rankingFilter | |
| type = object · requires: comparisonMeasureValueFilter | |
| type = object · requires: rangeMeasureValueFilter | |
| type = object · requires: absoluteDateFilter | |
| type = object · requires: relativeDateFilter | |
| type = object · requires: negativeAttributeFilter | |
| type = object · requires: positiveAttributeFilter |
Filter in form of direct MAQL query.
inlineobject · required
FilterDefinitionForSimpleMeasure
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = object |
Abstract filter definition type for dates.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: absoluteDateFilter | |
| type = object · requires: relativeDateFilter |
A datetime filter specifying exact from and to values.
absoluteDateFilterobject · required
ForecastRequest
forecastPeriodinteger · int32 · requiredNumber of future periods that should be forecasted
confidenceLevelnumber · floatConfidence interval boundary value.
Default: 0.95seasonalbooleanWhether the input data is seasonal
Default: false
ForecastResult
attributestring[] · requiredlowerBound(number | null)[] · requiredorigin(number | null)[] · requiredprediction(number | null)[] · requiredupperBound(number | null)[] · required
FoundObjects
objectsobject[] · requiredList of objects found with a similarity search.
reasoningstring · requiredDEPRECATED: Use top-level reasoning.steps instead. Reasoning from LLM. Description of how and why the answer was generated.
FrequencyProperties
valueLimitinteger · int32The maximum number of distinct values to return.
Default: 10
GdStorageFile
modifiedAtstring · date-time · requiredLast modification timestamp of the file.
namestring · requiredName of the file.
sizeinteger · int64 · requiredSize of the file in bytes.
typestring · enum · requiredType of the file.
Enum values:CSV
GenerateLdmRequest
aggregatedFactPrefixstringColumns starting with this prefix will be considered as aggregated facts. The prefix is then followed by the value of
separatorparameter. Given the aggregated fact prefix isaggrand separator is__, the columns with name likeaggr__sum__product__soldwill be considered as aggregated sold fact in the product table with SUM aggregate function.Example: aggrdateGranularitiesstringOption to control date granularities for date datasets. Empty value enables common date granularities (DAY, WEEK, MONTH, QUARTER, YEAR). Default value is
allwhich enables all available date granularities, including time granularities (like hours, minutes).Example: alldateReferencePrefixstringColumns starting with this prefix will be considered as references to date dataset. The prefix is then followed by the value of
separatorparameter. Given the reference prefix isdand separator is__, the columns with name liked__datewill be considered as reference to date dataset. There can be also second separator and granularity suffix, e.g.d__date__dayto create attribute reference to exact date dataset and granularity.Example: ddenormPrefixstringColumns starting with this prefix will be considered as denormalization references. The prefix is then followed by the value of
separatorparameter. Given the denormalization reference prefix isdrand separator is__, the columns with name likedr__customer_namewill be considered as denormalization references.Example: drfactPrefixstringColumns starting with this prefix will be considered as facts. The prefix is then followed by the value of
separatorparameter. Given the fact prefix isfand separator is__, the columns with name likef__soldwill be considered as facts.Example: fgenerateLongIdsbooleanA flag dictating how the attribute, fact and label ids are generated. By default their ids are derived only from the column name, unless there would be a conflict (e.g. category coming from two different tables). In that case a long id format of
<table>.<column>is used. If the flag is set to true, then all ids will be generated in the long form.Default: falsegrainMultivalueReferencePrefixstringColumns starting with this prefix will be considered as grain multivalue references. The prefix is then followed by the value of
separatorparameter. Given the reference prefix isgrmrand separator is__, the columns with name likegrmr__customer__customer_idwill be considered as grain multivalue references to customer_id in customer table.Example: grmrgrainPrefixstringColumns starting with this prefix will be considered as grains. The prefix is then followed by the value of
separatorparameter. Given the grain prefix isgrand separator is__, the columns with name likegr__namewill be considered as grains.Example: grgrainReferencePrefixstringColumns starting with this prefix will be considered as grain references. The prefix is then followed by the value of
separatorparameter. For composite references, the reference is multivalue if at least one column is multivalue. Given the reference prefix isgrrand separator is__, the columns with name likegrr__customer__customer_idwill be considered as grain references to customer_id in customer table.Example: grrmultivalueReferencePrefixstringColumns starting with this prefix will be considered as multivalue references. The prefix is then followed by the value of
separatorparameter. For composite references, the reference is multivalue if at least one column is multivalue. Given the reference prefix ismrand separator is__, the columns with name likemr__customer__customer_idwill be considered as multivalue references to customer_id in customer table.Example: mrpdmobjectPDM additions wrapper.
primaryLabelPrefixstringColumns starting with this prefix will be considered as primary labels. The prefix is then followed by the value of
separatorparameter. Given the primary label prefix ispland separator is__, the columns with name likepl__country_idwill be considered as primary labels.Example: plreferencePrefixstringColumns starting with this prefix will be considered as references. The prefix is then followed by the value of
separatorparameter. Given the reference prefix isrand separator is__, the columns with name liker__customer__customer_idwill be considered as references to customer_id in customer table.Example: rsecondaryLabelPrefixstringColumns starting with this prefix will be considered as secondary labels. The prefix is then followed by the value of
separatorparameter. Given the secondary label prefix islsand separator is__, the columns with name likels__country_id__country_namewill be considered as secondary labels.Example: lsseparatorstringA separator between prefixes and the names. Default is "__".
Default: __translationPrefixstringColumns starting with this prefix will be considered as secondary label translation. The prefix is then followed by the value of
separatorparameter. Given the translation prefix istrand separator is__, the columns with name liketr__attribute__label__en-USwill be considered as secondary label en-US translation tolabellabel inattributeattribute.Example: trwdfPrefixstringColumn serving as workspace data filter. No labels are auto generated for such columns.
Default: wdfworkspaceIdstringOptional workspace id.
tablePrefixstring · deprecated · requiredTables starting with this prefix will be included. The prefix is then followed by the value of
separatorparameter. Given the table prefix isout_tableand separator is__, the table with name likeout_table__customerswill be scanned.Example: out_tableviewPrefixstring · deprecated · requiredViews starting with this prefix will be included. The prefix is then followed by the value of
separatorparameter. Given the view prefix isout_viewand separator is__, the table with name likeout_view__us_customerswill be scanned.Example: out_view
GeoJsonFeature
propertiesobject · requiredtypestring · required
geometryobjectGeoJSON Geometry
idobject
GetQualityIssuesResponse
issuesobject[] · requiredList of quality issues found in the workspace
statusstring · enum · requiredStatus of the latest triggered quality check process
Enum values:RUNNINGCOMPLETEDFAILEDNOT_FOUNDDISABLED
updatedAtstringTimestamp when the quality issues were last updated (ISO format)
GrainIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredGrain ID.
Example: attr.customers.customer_nametypestring · enum · requiredA type of the grain.
Enum values:attributedateExample: ATTRIBUTE
GrantedPermission
levelstring · requiredLevel of permission
Example: VIEW, SHARE, EDITsourcestring · requiredSource of permission
Example: direct/indirect
GranularitiesFormatting
titleBasestring · maxLength: 255 · requiredTitle base is used as a token in title pattern. If left empty, it is replaced by date dataset title.
titlePatternstring · maxLength: 255 · requiredThis pattern is used to generate the title of attributes and labels that result from the granularities. There are two tokens available:
%titleBase- represents shared part by all titles, or title of Date Dataset if left empty%granularityTitle- representsDateGranularitybuilt-in title
Example: %titleBase - %granularityTitle
HierarchyObjectIdentification
idstring · requiredtypestring · enum · requiredEnum values:analyticalDashboardattributedashboardPlugindatasetfactlabelmetricpromptExample: metric
HistogramBucket
countinteger · int64 · requiredlowerBoundnumber · double · requiredupperBoundnumber · double · required
IdentifierDuplications
idstring · requiredoriginsstring[] · requiredtypestring · enum · requiredEnum values:analyticalDashboardattributedashboardPlugindatasetfactlabelmetricpromptExample: metric
ImageExportRequest
dashboardIdstring · requiredDashboard identifier
Example: 761cd28b-3f57-4ac9-bbdc-1c552cc0d1d0fileNamestring · requiredFile name to be used for retrieving the image document.
Example: filenameformatstring · enum · requiredRequested resulting file type.
Enum values:PNGExample: PNGwidgetIdsstring[] · minItems: 1 · maxItems: 1 · unique · requiredList of widget identifiers to be exported. Note that only one widget is currently supported.
metadataobject | null · maxLength: 15000Free-form JSON object
Example: {}
ImportCsvRequestTable
namestring · requiredName of the table.
sourceobject · requiredInformation about source data for a particular table.
ImportCsvRequestTableSource
configobject · requiredConfig to use when accessing the data for executions, etc.
locationstring · requiredLocation of the data in the staging area.
ImportCsvRequestTableSourceConfig
columnDateFormatsobjectDate formats to use to use to read the given columns.
convertOptionsobjectOptions for converting CSV files when reading.
parseOptionsobjectOptions for parsing CSV files.
readOptionsobjectOptions for reading CSV files.
ImportCsvResponse
namestring · requiredName of the table the file was imported to.
versioninteger · int32 · requiredVersion the file was imported as.
JsonApiAggregatedFactLinkage
idstring · requiredtypestring · enum · requiredEnum values:aggregatedFact
JsonApiAggregatedFactOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:aggregatedFactExample: aggregatedFact
metaobjectrelationshipsobject
JsonApiAggregatedFactOutDocument
dataobject · requiredJSON:API representation of aggregatedFact entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiAggregatedFactOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: attributes, id, type | |
| type = object · requires: id, type |
JSON:API representation of dataset entity.
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:datasetExample: dataset
metaobjectrelationshipsobjectlinksobject
JsonApiAggregatedFactOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiAggregatedFactOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:aggregatedFactExample: aggregatedFact
metaobjectrelationshipsobjectlinksobject
JsonApiAggregatedFactToManyLinkage
idstring · requiredtypestring · enum · requiredEnum values:aggregatedFact
JsonApiAnalyticalDashboardIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:analyticalDashboardExample: analyticalDashboard
JsonApiAnalyticalDashboardInDocument
dataobject · requiredJSON:API representation of analyticalDashboard entity.
JsonApiAnalyticalDashboardLinkage
idstring · requiredtypestring · enum · requiredEnum values:analyticalDashboard
JsonApiAnalyticalDashboardOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:analyticalDashboardExample: analyticalDashboard
metaobjectrelationshipsobject
JsonApiAnalyticalDashboardOutDocument
dataobject · requiredJSON:API representation of analyticalDashboard entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiAnalyticalDashboardOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: id, type |
JSON:API representation of userIdentifier entity.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userIdentifierExample: userIdentifier
attributesobjectlinksobject
JsonApiAnalyticalDashboardOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiAnalyticalDashboardOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:analyticalDashboardExample: analyticalDashboard
metaobjectrelationshipsobjectlinksobject
JsonApiAnalyticalDashboardPatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:analyticalDashboardExample: analyticalDashboard
JsonApiAnalyticalDashboardPatchDocument
dataobject · requiredJSON:API representation of patching analyticalDashboard entity.
JsonApiAnalyticalDashboardPostOptionalId
attributesobject · requiredtypestring · enum · requiredObject type
Enum values:analyticalDashboardExample: analyticalDashboard
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiAnalyticalDashboardPostOptionalIdDocument
dataobject · requiredJSON:API representation of analyticalDashboard entity.
JsonApiAnalyticalDashboardToManyLinkage
idstring · requiredtypestring · enum · requiredEnum values:analyticalDashboard
JsonApiAnalyticalDashboardToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:analyticalDashboard
JsonApiApiTokenIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:apiTokenExample: apiToken
JsonApiApiTokenOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:apiTokenExample: apiToken
attributesobject
JsonApiApiTokenOutDocument
dataobject · requiredJSON:API representation of apiToken entity.
linksobject
JsonApiApiTokenOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:apiTokenExample: apiToken
attributesobjectlinksobject
JsonApiAttributeHierarchyIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:attributeHierarchyExample: attributeHierarchy
attributesobject
JsonApiAttributeHierarchyInDocument
dataobject · requiredJSON:API representation of attributeHierarchy entity.
JsonApiAttributeHierarchyLinkage
idstring · requiredtypestring · enum · requiredEnum values:attributeHierarchy
JsonApiAttributeHierarchyOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:attributeHierarchyExample: attributeHierarchy
attributesobjectmetaobjectrelationshipsobject
JsonApiAttributeHierarchyOutDocument
dataobject · requiredJSON:API representation of attributeHierarchy entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiAttributeHierarchyOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type | |
| type = object · requires: id, type |
JSON:API representation of userIdentifier entity.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userIdentifierExample: userIdentifier
attributesobjectlinksobject
JsonApiAttributeHierarchyOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiAttributeHierarchyOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:attributeHierarchyExample: attributeHierarchy
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiAttributeHierarchyPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:attributeHierarchyExample: attributeHierarchy
attributesobject
JsonApiAttributeHierarchyPatchDocument
dataobject · requiredJSON:API representation of patching attributeHierarchy entity.
JsonApiAttributeHierarchyToManyLinkage
idstring · requiredtypestring · enum · requiredEnum values:attributeHierarchy
JsonApiAttributeOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:attributeExample: attribute
attributesobjectmetaobjectrelationshipsobject
JsonApiAttributeOutDocument
dataobject · requiredJSON:API representation of attribute entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiAttributeOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: attributes, id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type |
JSON:API representation of dataset entity.
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:datasetExample: dataset
metaobjectrelationshipsobjectlinksobject
JsonApiAttributeOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiAttributeOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:attributeExample: attribute
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiAttributePatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:attributeExample: attribute
attributesobjectrelationshipsobject
JsonApiAttributePatchDocument
dataobject · requiredJSON:API representation of patching attribute entity.
JsonApiAttributeToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:attribute
JsonApiAutomationIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:automationExample: automation
attributesobjectrelationshipsobject
JsonApiAutomationOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:automationExample: automation
attributesobjectmetaobjectrelationshipsobject
JsonApiAutomationOutDocument
dataobject · requiredJSON:API representation of automation entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiAutomationOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: attributes, id, type |
JSON:API representation of notificationChannel entity.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:notificationChannelExample: notificationChannel
attributesobjectlinksobject
JsonApiAutomationOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiAutomationOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:automationExample: automation
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiAutomationPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:automationExample: automation
attributesobjectrelationshipsobject
JsonApiAutomationPatchDocument
dataobject · requiredJSON:API representation of patching automation entity.
JsonApiAutomationResultLinkage
idstring · requiredtypestring · enum · requiredEnum values:automationResult
JsonApiAutomationResultOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:automationResultExample: automationResult
relationshipsobject
JsonApiAutomationResultOutList
dataobject[] · unique · required
includedobject[] · uniqueIncluded resources
linksobjectmetaobject
JsonApiAutomationResultOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:automationResultExample: automationResult
relationshipsobjectlinksobject
JsonApiAutomationResultToManyLinkage
idstring · requiredtypestring · enum · requiredEnum values:automationResult
JsonApiAutomationToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:automation
JsonApiColorPaletteIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:colorPaletteExample: colorPalette
JsonApiColorPaletteOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:colorPaletteExample: colorPalette
JsonApiColorPaletteOutDocument
dataobject · requiredJSON:API representation of colorPalette entity.
linksobject
JsonApiColorPaletteOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:colorPaletteExample: colorPalette
linksobject
JsonApiColorPalettePatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:colorPaletteExample: colorPalette
JsonApiColorPalettePatchDocument
dataobject · requiredJSON:API representation of patching colorPalette entity.
JsonApiCookieSecurityConfigurationIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:cookieSecurityConfigurationExample: cookieSecurityConfiguration
attributesobject
JsonApiCookieSecurityConfigurationInDocument
dataobject · requiredJSON:API representation of cookieSecurityConfiguration entity.
JsonApiCookieSecurityConfigurationOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:cookieSecurityConfigurationExample: cookieSecurityConfiguration
attributesobject
JsonApiCookieSecurityConfigurationOutDocument
dataobject · requiredJSON:API representation of cookieSecurityConfiguration entity.
linksobject
JsonApiCookieSecurityConfigurationPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:cookieSecurityConfigurationExample: cookieSecurityConfiguration
attributesobject
JsonApiCookieSecurityConfigurationPatchDocument
dataobject · requiredJSON:API representation of patching cookieSecurityConfiguration entity.
JsonApiCspDirectiveIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:cspDirectiveExample: cspDirective
JsonApiCspDirectiveOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:cspDirectiveExample: cspDirective
JsonApiCspDirectiveOutDocument
dataobject · requiredJSON:API representation of cspDirective entity.
linksobject
JsonApiCspDirectiveOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:cspDirectiveExample: cspDirective
linksobject
JsonApiCspDirectivePatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:cspDirectiveExample: cspDirective
JsonApiCspDirectivePatchDocument
dataobject · requiredJSON:API representation of patching cspDirective entity.
JsonApiCustomApplicationSettingIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:customApplicationSettingExample: customApplicationSetting
JsonApiCustomApplicationSettingInDocument
dataobject · requiredJSON:API representation of customApplicationSetting entity.
JsonApiCustomApplicationSettingOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:customApplicationSettingExample: customApplicationSetting
metaobject
JsonApiCustomApplicationSettingOutDocument
dataobject · requiredJSON:API representation of customApplicationSetting entity.
linksobject
JsonApiCustomApplicationSettingOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:customApplicationSettingExample: customApplicationSetting
metaobjectlinksobject
JsonApiCustomApplicationSettingPatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:customApplicationSettingExample: customApplicationSetting
JsonApiCustomApplicationSettingPatchDocument
dataobject · requiredJSON:API representation of patching customApplicationSetting entity.
JsonApiCustomApplicationSettingPostOptionalId
attributesobject · requiredtypestring · enum · requiredObject type
Enum values:customApplicationSettingExample: customApplicationSetting
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiCustomApplicationSettingPostOptionalIdDocument
dataobject · requiredJSON:API representation of customApplicationSetting entity.
JsonApiDashboardPluginIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:dashboardPluginExample: dashboardPlugin
attributesobject
JsonApiDashboardPluginInDocument
dataobject · requiredJSON:API representation of dashboardPlugin entity.
JsonApiDashboardPluginLinkage
idstring · requiredtypestring · enum · requiredEnum values:dashboardPlugin
JsonApiDashboardPluginOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:dashboardPluginExample: dashboardPlugin
attributesobjectmetaobjectrelationshipsobject
JsonApiDashboardPluginOutDocument
dataobject · requiredJSON:API representation of dashboardPlugin entity.
includedobject[] · uniqueIncluded resources
linksobject
JsonApiDashboardPluginOutList
dataobject[] · unique · required
includedobject[] · uniqueIncluded resources
linksobjectmetaobject
JsonApiDashboardPluginOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:dashboardPluginExample: dashboardPlugin
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiDashboardPluginPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:dashboardPluginExample: dashboardPlugin
attributesobject
JsonApiDashboardPluginPatchDocument
dataobject · requiredJSON:API representation of patching dashboardPlugin entity.
JsonApiDashboardPluginPostOptionalId
typestring · enum · requiredObject type
Enum values:dashboardPluginExample: dashboardPlugin
attributesobjectidstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiDashboardPluginPostOptionalIdDocument
dataobject · requiredJSON:API representation of dashboardPlugin entity.
JsonApiDashboardPluginToManyLinkage
idstring · requiredtypestring · enum · requiredEnum values:dashboardPlugin
JsonApiDataSourceIdentifierOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:dataSourceIdentifierExample: dataSourceIdentifier
metaobject
JsonApiDataSourceIdentifierOutDocument
dataobject · requiredJSON:API representation of dataSourceIdentifier entity.
linksobject
JsonApiDataSourceIdentifierOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:dataSourceIdentifierExample: dataSourceIdentifier
metaobjectlinksobject
JsonApiDataSourceIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:dataSourceExample: dataSource
JsonApiDataSourceOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:dataSourceExample: dataSource
metaobject
JsonApiDataSourceOutDocument
dataobject · requiredJSON:API representation of dataSource entity.
linksobject
JsonApiDataSourceOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:dataSourceExample: dataSource
metaobjectlinksobject
JsonApiDataSourcePatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:dataSourceExample: dataSource
JsonApiDataSourcePatchDocument
dataobject · requiredJSON:API representation of patching dataSource entity.
JsonApiDatasetOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:datasetExample: dataset
metaobjectrelationshipsobject
JsonApiDatasetOutDocument
dataobject · requiredJSON:API representation of dataset entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiDatasetOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: id, type |
JSON:API representation of attribute entity.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:attributeExample: attribute
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiDatasetOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiDatasetOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:datasetExample: dataset
metaobjectrelationshipsobjectlinksobject
JsonApiDatasetPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:datasetExample: dataset
attributesobject
JsonApiDatasetPatchDocument
dataobject · requiredJSON:API representation of patching dataset entity.
JsonApiDatasetToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:dataset
JsonApiEntitlementOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:entitlementExample: entitlement
attributesobject
JsonApiEntitlementOutDocument
dataobject · requiredJSON:API representation of entitlement entity.
linksobject
JsonApiEntitlementOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:entitlementExample: entitlement
attributesobjectlinksobject
JsonApiExportDefinitionIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:exportDefinitionExample: exportDefinition
attributesobjectrelationshipsobject
JsonApiExportDefinitionInDocument
dataobject · requiredJSON:API representation of exportDefinition entity.
JsonApiExportDefinitionLinkage
idstring · requiredtypestring · enum · requiredEnum values:exportDefinition
JsonApiExportDefinitionOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:exportDefinitionExample: exportDefinition
attributesobjectmetaobjectrelationshipsobject
JsonApiExportDefinitionOutDocument
dataobject · requiredJSON:API representation of exportDefinition entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiExportDefinitionOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: attributes, id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type |
JSON:API representation of visualizationObject entity.
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:visualizationObjectExample: visualizationObject
metaobjectrelationshipsobjectlinksobject
JsonApiExportDefinitionOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiExportDefinitionOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:exportDefinitionExample: exportDefinition
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiExportDefinitionPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:exportDefinitionExample: exportDefinition
attributesobjectrelationshipsobject
JsonApiExportDefinitionPatchDocument
dataobject · requiredJSON:API representation of patching exportDefinition entity.
JsonApiExportDefinitionPostOptionalId
typestring · enum · requiredObject type
Enum values:exportDefinitionExample: exportDefinition
attributesobjectidstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1relationshipsobject
JsonApiExportDefinitionPostOptionalIdDocument
dataobject · requiredJSON:API representation of exportDefinition entity.
JsonApiExportDefinitionToManyLinkage
idstring · requiredtypestring · enum · requiredEnum values:exportDefinition
JsonApiExportTemplateIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:exportTemplateExample: exportTemplate
JsonApiExportTemplateInDocument
dataobject · requiredJSON:API representation of exportTemplate entity.
JsonApiExportTemplateOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:exportTemplateExample: exportTemplate
JsonApiExportTemplateOutDocument
dataobject · requiredJSON:API representation of exportTemplate entity.
linksobject
JsonApiExportTemplateOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:exportTemplateExample: exportTemplate
linksobject
JsonApiExportTemplatePatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:exportTemplateExample: exportTemplate
JsonApiExportTemplatePatchDocument
dataobject · requiredJSON:API representation of patching exportTemplate entity.
JsonApiExportTemplatePostOptionalId
attributesobject · requiredtypestring · enum · requiredObject type
Enum values:exportTemplateExample: exportTemplate
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiExportTemplatePostOptionalIdDocument
dataobject · requiredJSON:API representation of exportTemplate entity.
JsonApiFactOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:factExample: fact
attributesobjectmetaobjectrelationshipsobject
JsonApiFactOutDocument
dataobject · requiredJSON:API representation of fact entity.
includedobject[] · uniqueIncluded resources
linksobject
JsonApiFactOutList
dataobject[] · unique · required
includedobject[] · uniqueIncluded resources
linksobjectmetaobject
JsonApiFactOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:factExample: fact
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiFactPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:factExample: fact
attributesobject
JsonApiFactToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:fact
JsonApiFilterContextIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:filterContextExample: filterContext
JsonApiFilterContextInDocument
dataobject · requiredJSON:API representation of filterContext entity.
JsonApiFilterContextLinkage
idstring · requiredtypestring · enum · requiredEnum values:filterContext
JsonApiFilterContextOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:filterContextExample: filterContext
metaobjectrelationshipsobject
JsonApiFilterContextOutDocument
dataobject · requiredJSON:API representation of filterContext entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiFilterContextOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: id, type |
JSON:API representation of attribute entity.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:attributeExample: attribute
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiFilterContextOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiFilterContextOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:filterContextExample: filterContext
metaobjectrelationshipsobjectlinksobject
JsonApiFilterContextPatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:filterContextExample: filterContext
JsonApiFilterContextPatchDocument
dataobject · requiredJSON:API representation of patching filterContext entity.
JsonApiFilterContextPostOptionalId
attributesobject · requiredtypestring · enum · requiredObject type
Enum values:filterContextExample: filterContext
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiFilterContextPostOptionalIdDocument
dataobject · requiredJSON:API representation of filterContext entity.
JsonApiFilterContextToManyLinkage
idstring · requiredtypestring · enum · requiredEnum values:filterContext
JsonApiFilterViewIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:filterViewExample: filterView
relationshipsobject
JsonApiFilterViewOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:filterViewExample: filterView
relationshipsobject
JsonApiFilterViewOutDocument
dataobject · requiredJSON:API representation of filterView entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiFilterViewOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: attributes, id, type | |
| type = object · requires: id, type |
JSON:API representation of analyticalDashboard entity.
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:analyticalDashboardExample: analyticalDashboard
metaobjectrelationshipsobjectlinksobject
JsonApiFilterViewOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiFilterViewOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:filterViewExample: filterView
relationshipsobjectlinksobject
JsonApiFilterViewPatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:filterViewExample: filterView
relationshipsobject
JsonApiFilterViewPatchDocument
dataobject · requiredJSON:API representation of patching filterView entity.
JsonApiIdentityProviderIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:identityProviderExample: identityProvider
attributesobject
JsonApiIdentityProviderInDocument
dataobject · requiredJSON:API representation of identityProvider entity.
JsonApiIdentityProviderLinkage
idstring · requiredtypestring · enum · requiredEnum values:identityProvider
JsonApiIdentityProviderOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:identityProviderExample: identityProvider
attributesobject
JsonApiIdentityProviderOutDocument
dataobject · requiredJSON:API representation of identityProvider entity.
linksobject
JsonApiIdentityProviderOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:identityProviderExample: identityProvider
attributesobjectlinksobject
JsonApiIdentityProviderPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:identityProviderExample: identityProvider
attributesobject
JsonApiIdentityProviderPatchDocument
dataobject · requiredJSON:API representation of patching identityProvider entity.
JsonApiIdentityProviderToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:identityProvider
JsonApiJwkIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:jwkExample: jwk
attributesobject
JsonApiJwkOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:jwkExample: jwk
attributesobject
JsonApiJwkOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:jwkExample: jwk
attributesobjectlinksobject
JsonApiJwkPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:jwkExample: jwk
attributesobject
JsonApiKnowledgeRecommendationIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1relationshipsobject · requiredtypestring · enum · requiredObject type
Enum values:knowledgeRecommendationExample: knowledgeRecommendation
JsonApiKnowledgeRecommendationInDocument
dataobject · requiredJSON:API representation of knowledgeRecommendation entity.
JsonApiKnowledgeRecommendationOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:knowledgeRecommendationExample: knowledgeRecommendation
metaobjectrelationshipsobject
JsonApiKnowledgeRecommendationOutDocument
dataobject · requiredJSON:API representation of knowledgeRecommendation entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiKnowledgeRecommendationOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: attributes, id, type | |
| type = object · requires: attributes, id, type |
JSON:API representation of metric entity.
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:metricExample: metric
metaobjectrelationshipsobjectlinksobject
JsonApiKnowledgeRecommendationOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiKnowledgeRecommendationOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:knowledgeRecommendationExample: knowledgeRecommendation
metaobjectrelationshipsobjectlinksobject
JsonApiKnowledgeRecommendationPatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1relationshipsobject · requiredtypestring · enum · requiredObject type
Enum values:knowledgeRecommendationExample: knowledgeRecommendation
JsonApiKnowledgeRecommendationPatchDocument
dataobject · requiredJSON:API representation of patching knowledgeRecommendation entity.
JsonApiKnowledgeRecommendationPostOptionalId
attributesobject · requiredrelationshipsobject · requiredtypestring · enum · requiredObject type
Enum values:knowledgeRecommendationExample: knowledgeRecommendation
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiKnowledgeRecommendationPostOptionalIdDocument
dataobject · requiredJSON:API representation of knowledgeRecommendation entity.
JsonApiLabelOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:labelExample: label
attributesobjectmetaobjectrelationshipsobject
JsonApiLabelOutDocument
dataobject · requiredJSON:API representation of label entity.
includedobject[] · uniqueIncluded resources
linksobject
JsonApiLabelOutList
dataobject[] · unique · required
includedobject[] · uniqueIncluded resources
linksobjectmetaobject
JsonApiLabelOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:labelExample: label
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiLabelPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:labelExample: label
attributesobject
JsonApiLabelToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:label
JsonApiLlmEndpointIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:llmEndpointExample: llmEndpoint
JsonApiLlmEndpointOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:llmEndpointExample: llmEndpoint
JsonApiLlmEndpointOutDocument
dataobject · requiredJSON:API representation of llmEndpoint entity.
linksobject
JsonApiLlmEndpointOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:llmEndpointExample: llmEndpoint
linksobject
JsonApiLlmEndpointPatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:llmEndpointExample: llmEndpoint
JsonApiLlmEndpointPatchDocument
dataobject · requiredJSON:API representation of patching llmEndpoint entity.
JsonApiMemoryItemIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:memoryItemExample: memoryItem
JsonApiMemoryItemOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:memoryItemExample: memoryItem
metaobjectrelationshipsobject
JsonApiMemoryItemOutDocument
dataobject · requiredJSON:API representation of memoryItem entity.
includedobject[] · uniqueIncluded resources
linksobject
JsonApiMemoryItemOutList
dataobject[] · unique · required
includedobject[] · uniqueIncluded resources
linksobjectmetaobject
JsonApiMemoryItemOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:memoryItemExample: memoryItem
metaobjectrelationshipsobjectlinksobject
JsonApiMemoryItemPatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:memoryItemExample: memoryItem
JsonApiMemoryItemPatchDocument
dataobject · requiredJSON:API representation of patching memoryItem entity.
JsonApiMemoryItemPostOptionalId
attributesobject · requiredtypestring · enum · requiredObject type
Enum values:memoryItemExample: memoryItem
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiMemoryItemPostOptionalIdDocument
dataobject · requiredJSON:API representation of memoryItem entity.
JsonApiMetricIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:metricExample: metric
JsonApiMetricOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:metricExample: metric
metaobjectrelationshipsobject
JsonApiMetricOutDocument
dataobject · requiredJSON:API representation of metric entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiMetricOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: attributes, id, type |
JSON:API representation of userIdentifier entity.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userIdentifierExample: userIdentifier
attributesobjectlinksobject
JsonApiMetricOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiMetricOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:metricExample: metric
metaobjectrelationshipsobjectlinksobject
JsonApiMetricPatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:metricExample: metric
JsonApiMetricPostOptionalId
attributesobject · requiredtypestring · enum · requiredObject type
Enum values:metricExample: metric
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiMetricToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:metric
JsonApiNotificationChannelIdentifierOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:notificationChannelIdentifierExample: notificationChannelIdentifier
attributesobject
JsonApiNotificationChannelIdentifierOutDocument
dataobject · requiredJSON:API representation of notificationChannelIdentifier entity.
linksobject
JsonApiNotificationChannelIdentifierOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:notificationChannelIdentifierExample: notificationChannelIdentifier
attributesobjectlinksobject
JsonApiNotificationChannelIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:notificationChannelExample: notificationChannel
attributesobject
JsonApiNotificationChannelInDocument
dataobject · requiredJSON:API representation of notificationChannel entity.
JsonApiNotificationChannelLinkage
idstring · requiredtypestring · enum · requiredEnum values:notificationChannel
JsonApiNotificationChannelOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:notificationChannelExample: notificationChannel
attributesobject
JsonApiNotificationChannelOutDocument
dataobject · requiredJSON:API representation of notificationChannel entity.
linksobject
JsonApiNotificationChannelOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:notificationChannelExample: notificationChannel
attributesobjectlinksobject
JsonApiNotificationChannelPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:notificationChannelExample: notificationChannel
attributesobject
JsonApiNotificationChannelPatchDocument
dataobject · requiredJSON:API representation of patching notificationChannel entity.
JsonApiNotificationChannelPostOptionalId
typestring · enum · requiredObject type
Enum values:notificationChannelExample: notificationChannel
attributesobjectidstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiNotificationChannelPostOptionalIdDocument
dataobject · requiredJSON:API representation of notificationChannel entity.
JsonApiNotificationChannelToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:notificationChannel
JsonApiOrganizationIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:organizationExample: organization
attributesobjectrelationshipsobject
JsonApiOrganizationOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:organizationExample: organization
attributesobjectmetaobjectrelationshipsobject
JsonApiOrganizationOutDocument
dataobject · requiredJSON:API representation of organization entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiOrganizationOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type |
JSON:API representation of user entity.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userExample: user
attributesobjectrelationshipsobjectlinksobject
JsonApiOrganizationPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:organizationExample: organization
attributesobjectrelationshipsobject
JsonApiOrganizationPatchDocument
dataobject · requiredJSON:API representation of patching organization entity.
JsonApiOrganizationSettingIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:organizationSettingExample: organizationSetting
attributesobject
JsonApiOrganizationSettingInDocument
dataobject · requiredJSON:API representation of organizationSetting entity.
JsonApiOrganizationSettingOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:organizationSettingExample: organizationSetting
attributesobject
JsonApiOrganizationSettingOutDocument
dataobject · requiredJSON:API representation of organizationSetting entity.
linksobject
JsonApiOrganizationSettingOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:organizationSettingExample: organizationSetting
attributesobjectlinksobject
JsonApiOrganizationSettingPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:organizationSettingExample: organizationSetting
attributesobject
JsonApiOrganizationSettingPatchDocument
dataobject · requiredJSON:API representation of patching organizationSetting entity.
JsonApiThemeIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:themeExample: theme
JsonApiThemeOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:themeExample: theme
JsonApiThemeOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:themeExample: theme
linksobject
JsonApiThemePatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:themeExample: theme
JsonApiUserDataFilterIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userDataFilterExample: userDataFilter
relationshipsobject
JsonApiUserDataFilterInDocument
dataobject · requiredJSON:API representation of userDataFilter entity.
JsonApiUserDataFilterOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userDataFilterExample: userDataFilter
metaobjectrelationshipsobject
JsonApiUserDataFilterOutDocument
dataobject · requiredJSON:API representation of userDataFilter entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiUserDataFilterOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: attributes, id, type |
JSON:API representation of user entity.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userExample: user
attributesobjectrelationshipsobjectlinksobject
JsonApiUserDataFilterOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiUserDataFilterOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userDataFilterExample: userDataFilter
metaobjectrelationshipsobjectlinksobject
JsonApiUserDataFilterPatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userDataFilterExample: userDataFilter
relationshipsobject
JsonApiUserDataFilterPatchDocument
dataobject · requiredJSON:API representation of patching userDataFilter entity.
JsonApiUserDataFilterPostOptionalId
attributesobject · requiredtypestring · enum · requiredObject type
Enum values:userDataFilterExample: userDataFilter
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1relationshipsobject
JsonApiUserDataFilterPostOptionalIdDocument
dataobject · requiredJSON:API representation of userDataFilter entity.
JsonApiUserGroupIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userGroupExample: userGroup
attributesobjectrelationshipsobject
JsonApiUserGroupOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userGroupExample: userGroup
attributesobjectrelationshipsobject
JsonApiUserGroupOutDocument
dataobject · requiredJSON:API representation of userGroup entity.
includedobject[] · uniqueIncluded resources
linksobject
JsonApiUserGroupOutList
dataobject[] · unique · required
includedobject[] · uniqueIncluded resources
linksobjectmetaobject
JsonApiUserGroupOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userGroupExample: userGroup
attributesobjectrelationshipsobjectlinksobject
JsonApiUserGroupPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userGroupExample: userGroup
attributesobjectrelationshipsobject
JsonApiUserGroupPatchDocument
dataobject · requiredJSON:API representation of patching userGroup entity.
JsonApiUserGroupToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:userGroup
JsonApiUserIdentifierLinkage
idstring · requiredtypestring · enum · requiredEnum values:userIdentifier
JsonApiUserIdentifierOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userIdentifierExample: userIdentifier
attributesobject
JsonApiUserIdentifierOutDocument
dataobject · requiredJSON:API representation of userIdentifier entity.
linksobject
JsonApiUserIdentifierOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userIdentifierExample: userIdentifier
attributesobjectlinksobject
JsonApiUserIdentifierToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:userIdentifier
JsonApiUserIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userExample: user
attributesobjectrelationshipsobject
JsonApiUserOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userExample: user
attributesobjectrelationshipsobject
JsonApiUserOutDocument
dataobject · requiredJSON:API representation of user entity.
includedobject[] · uniqueIncluded resources
linksobject
JsonApiUserOutList
dataobject[] · unique · required
includedobject[] · uniqueIncluded resources
linksobjectmetaobject
JsonApiUserOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userExample: user
attributesobjectrelationshipsobjectlinksobject
JsonApiUserPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userExample: user
attributesobjectrelationshipsobject
JsonApiUserSettingIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userSettingExample: userSetting
attributesobject
JsonApiUserSettingOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userSettingExample: userSetting
attributesobject
JsonApiUserSettingOutDocument
dataobject · requiredJSON:API representation of userSetting entity.
linksobject
JsonApiUserSettingOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:userSettingExample: userSetting
attributesobjectlinksobject
JsonApiUserToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:user
JsonApiVisualizationObjectIn
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:visualizationObjectExample: visualizationObject
JsonApiVisualizationObjectInDocument
dataobject · requiredJSON:API representation of visualizationObject entity.
JsonApiVisualizationObjectLinkage
idstring · requiredtypestring · enum · requiredEnum values:visualizationObject
JsonApiVisualizationObjectOut
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:visualizationObjectExample: visualizationObject
metaobjectrelationshipsobject
JsonApiVisualizationObjectOutDocument
dataobject · requiredJSON:API representation of visualizationObject entity.
includedarray · uniqueIncluded resources
linksobject
JsonApiVisualizationObjectOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiVisualizationObjectOutWithLinks
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:visualizationObjectExample: visualizationObject
metaobjectrelationshipsobjectlinksobject
JsonApiVisualizationObjectPatch
attributesobject · requiredidstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:visualizationObjectExample: visualizationObject
JsonApiVisualizationObjectPatchDocument
dataobject · requiredJSON:API representation of patching visualizationObject entity.
JsonApiVisualizationObjectPostOptionalId
attributesobject · requiredtypestring · enum · requiredObject type
Enum values:visualizationObjectExample: visualizationObject
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiVisualizationObjectPostOptionalIdDocument
dataobject · requiredJSON:API representation of visualizationObject entity.
JsonApiVisualizationObjectToManyLinkage
idstring · requiredtypestring · enum · requiredEnum values:visualizationObject
JsonApiVisualizationObjectToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:visualizationObject
JsonApiWorkspaceAutomationOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceAutomationExample: workspaceAutomation
attributesobjectrelationshipsobject
JsonApiWorkspaceAutomationOutIncludes
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: attributes, id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: id, type | |
| type = object · requires: attributes, id, type |
JSON:API representation of workspace entity.
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceExample: workspace
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiWorkspaceAutomationOutList
dataobject[] · unique · required
includedarray · uniqueIncluded resources
linksobjectmetaobject
JsonApiWorkspaceAutomationOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceAutomationExample: workspaceAutomation
attributesobjectrelationshipsobjectlinksobject
JsonApiWorkspaceDataFilterIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceDataFilterExample: workspaceDataFilter
attributesobjectrelationshipsobject
JsonApiWorkspaceDataFilterInDocument
dataobject · requiredJSON:API representation of workspaceDataFilter entity.
JsonApiWorkspaceDataFilterLinkage
idstring · requiredtypestring · enum · requiredEnum values:workspaceDataFilter
JsonApiWorkspaceDataFilterOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceDataFilterExample: workspaceDataFilter
attributesobjectmetaobjectrelationshipsobject
JsonApiWorkspaceDataFilterOutDocument
dataobject · requiredJSON:API representation of workspaceDataFilter entity.
includedobject[] · uniqueIncluded resources
linksobject
JsonApiWorkspaceDataFilterOutList
dataobject[] · unique · required
includedobject[] · uniqueIncluded resources
linksobjectmetaobject
JsonApiWorkspaceDataFilterOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceDataFilterExample: workspaceDataFilter
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiWorkspaceDataFilterPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceDataFilterExample: workspaceDataFilter
attributesobjectrelationshipsobject
JsonApiWorkspaceDataFilterPatchDocument
dataobject · requiredJSON:API representation of patching workspaceDataFilter entity.
JsonApiWorkspaceDataFilterSettingIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceDataFilterSettingExample: workspaceDataFilterSetting
attributesobjectrelationshipsobject
JsonApiWorkspaceDataFilterSettingInDocument
dataobject · requiredJSON:API representation of workspaceDataFilterSetting entity.
JsonApiWorkspaceDataFilterSettingLinkage
idstring · requiredtypestring · enum · requiredEnum values:workspaceDataFilterSetting
JsonApiWorkspaceDataFilterSettingOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceDataFilterSettingExample: workspaceDataFilterSetting
attributesobjectmetaobjectrelationshipsobject
JsonApiWorkspaceDataFilterSettingOutDocument
dataobject · requiredJSON:API representation of workspaceDataFilterSetting entity.
includedobject[] · uniqueIncluded resources
linksobject
JsonApiWorkspaceDataFilterSettingOutList
dataobject[] · unique · required
includedobject[] · uniqueIncluded resources
linksobjectmetaobject
JsonApiWorkspaceDataFilterSettingOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceDataFilterSettingExample: workspaceDataFilterSetting
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiWorkspaceDataFilterSettingPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceDataFilterSettingExample: workspaceDataFilterSetting
attributesobjectrelationshipsobject
JsonApiWorkspaceDataFilterSettingPatchDocument
dataobject · requiredJSON:API representation of patching workspaceDataFilterSetting entity.
JsonApiWorkspaceDataFilterSettingToManyLinkage
idstring · requiredtypestring · enum · requiredEnum values:workspaceDataFilterSetting
JsonApiWorkspaceDataFilterToManyLinkage
idstring · requiredtypestring · enum · requiredEnum values:workspaceDataFilter
JsonApiWorkspaceDataFilterToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:workspaceDataFilter
JsonApiWorkspaceIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceExample: workspace
attributesobjectrelationshipsobject
JsonApiWorkspaceOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceExample: workspace
attributesobjectmetaobjectrelationshipsobject
JsonApiWorkspaceOutDocument
dataobject · requiredJSON:API representation of workspace entity.
includedobject[] · uniqueIncluded resources
linksobject
JsonApiWorkspaceOutList
dataobject[] · unique · required
includedobject[] · uniqueIncluded resources
linksobjectmetaobject
JsonApiWorkspaceOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceExample: workspace
attributesobjectmetaobjectrelationshipsobjectlinksobject
JsonApiWorkspacePatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceExample: workspace
attributesobjectrelationshipsobject
JsonApiWorkspacePatchDocument
dataobject · requiredJSON:API representation of patching workspace entity.
JsonApiWorkspaceSettingIn
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceSettingExample: workspaceSetting
attributesobject
JsonApiWorkspaceSettingInDocument
dataobject · requiredJSON:API representation of workspaceSetting entity.
JsonApiWorkspaceSettingOut
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceSettingExample: workspaceSetting
attributesobjectmetaobject
JsonApiWorkspaceSettingOutDocument
dataobject · requiredJSON:API representation of workspaceSetting entity.
linksobject
JsonApiWorkspaceSettingOutWithLinks
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceSettingExample: workspaceSetting
attributesobjectmetaobjectlinksobject
JsonApiWorkspaceSettingPatch
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredAPI identifier of an object
Example: id1typestring · enum · requiredObject type
Enum values:workspaceSettingExample: workspaceSetting
attributesobject
JsonApiWorkspaceSettingPatchDocument
dataobject · requiredJSON:API representation of patching workspaceSetting entity.
JsonApiWorkspaceSettingPostOptionalId
typestring · enum · requiredObject type
Enum values:workspaceSettingExample: workspaceSetting
attributesobjectidstring · pattern:^(?!\.)[.A-Za-z0-9_-…API identifier of an object
Example: id1
JsonApiWorkspaceSettingPostOptionalIdDocument
dataobject · requiredJSON:API representation of workspaceSetting entity.
JsonApiWorkspaceToOneLinkage
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: id, type |
The \"type\" and \"id\" to non-empty members.
idstring · requiredtypestring · enum · requiredEnum values:workspace
KeyDriversDimension
attributeobject · requiredObject identifier.
attributeNamestring · requiredlabelobject · requiredObject identifier.
labelNamestring · required
formatobjectAttribute format describes formatting information to effectively format attribute values when needed.
granularitystring · enumEnum values:MINUTEHOURDAYWEEKMONTHQUARTERYEARMINUTE_OF_HOURvalueTypestring · enumEnum values:TEXTHYPERLINKGEOGEO_LONGITUDEGEO_LATITUDEGEO_AREAIMAGE
KeyDriversRequest
metricobject · requiredMetric is a quantity that is calculated from the data.
auxMetricsobject[]Additional metrics to be included in the computation, but excluded from the analysis.
sortDirectionstring · enumSorting elements - ascending/descending order.
Enum values:ASCDESCDefault: DESC
KeyDriversResponse
dimensionsobject[] · requiredlinksobject · requiredLinks to the execution result.
LabelIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredLabel ID.
Example: label_idtypestring · enum · requiredA type of the label.
Enum values:labelExample: label
ListLinks
selfstring · uri · requiredA string containing the link's URL.
nextstring · uriA string containing the link's URL for the next page of data.
LocalIdentifier
localIdentifierstring · requiredLocal identifier of the metric to be compared.
Example: m1
formatstring | null · maxLength: 2048Metric format.
Example: #,##0Default: #,##0.00titlestring | null · maxLength: 255Metric title.
Example: Revenue
LocaleRequest
localestring · requiredRequested locale in the form of language tag (see RFC 5646).
Example: en-US
MatomoService
hoststring · requiredTelemetry host to send events to.
siteIdinteger · int32 · requiredSite ID on telemetry server.
reportingEndpointstringOptional reporting endpoint for proxying telemetry events.
MeasureDefinition
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: inline | |
| type = object · requires: arithmeticMeasure | |
| type = object · requires: measure | |
| type = object |
Metric defined by the raw MAQL query.
inlineobject · required
MeasureExecutionResultHeader
measureHeaderobject · requiredHeader containing the information related to metrics.
MeasureHeader
localIdentifierstring · requiredLocal identifier of the measure this header relates to.
formatstringFormat to be used to format the measure data.
namestringName of the measure.
MeasureItem
definitionobject · requiredAbstract metric definition type
localIdentifierstring · pattern:^[.a-zA-Z0-9_-]+$· requiredLocal identifier of the metric. This can be used to reference the metric in other parts of the execution definition.
Example: metric_1
MeasureValueFilter
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: comparisonMeasureValueFilter | |
| type = object · requires: rangeMeasureValueFilter |
Filter the result by comparing specified metric to given constant value, using given comparison operator.
comparisonMeasureValueFilterobject · required
MemoryItemCreatedByUsers
reasoningstring · requiredReasoning for error states
usersobject[] · requiredUsers who created memory item
MemoryItemUser
firstnamestring · requiredFirst name of the user who created memory item
lastnamestring · requiredLast name of the user who created memory item
userIdstring · requiredUser ID of the user who created memory item
Metric
idstring · requiredID of the object
Example: revenuetitlestring · requiredTitle of metric.
typestring · enum · requiredObject type
Enum values:metricfactattributeExample: metric
aggFunctionstring · enumAgg function. Empty if a stored metric is used.
Enum values:COUNTSUMMINMAXAVGMEDIAN
MetricValueChange
attributeNamestring · requiredThe name of the attribute being analyzed
attributeValuestring · requiredThe value of the attribute being analyzed
attributeValuesChangeMeannumber · double · requiredThe mean of attribute value changes for the attribute being analyzed
attributeValuesChangeStdnumber · double · requiredThe standard deviation of attribute value changes for the attribute being analyzed
isSignificantChangeboolean · requiredWhether the change is statistically significant
metricValueDeltanumber · double · requiredThe delta between analyzed and reference periods
metricValueDeltaAbsnumber · double · requiredThe absolute delta between analyzed and reference periods
metricValueInAnalyzedPeriodnumber · double · requiredThe metric value in the analyzed period
metricValueInReferencePeriodnumber · double · requiredThe metric value in the reference period
overallMetricValueInAnalyzedPeriodnumber · double · requiredThe overall metric value in the analyzed period
overallMetricValueInReferencePeriodnumber · double · requiredThe overall metric value in the reference period
Note
appliesTostring · enumEnum values:SOURCETARGETcategorystringcontentstringidstringotherAttributesobjectpriorityinteger · int32
Notification
createdAtstring · date-time · requireddatarequiredidstring · requiredisReadboolean · required
automationIdstringworkspaceIdstring
NotificationChannelDestination
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: type | |
| type = object · requires: type | |
| type = object · requires: type | |
| type = object · requires: type |
Webhook destination for notifications. The property url is required on create and update.
typestring · enum · requiredThe destination type.
Enum values:WEBHOOK
hasTokenboolean | null · maxLength: 10000 · readOnlyFlag indicating if webhook has a token.
tokenstring | null · maxLength: 10000 · writeOnlyBearer token for the webhook.
Example: secreturlstring · maxLength: 255 · pattern:(?=https?\://.*)(?=h…The webhook URL.
Example: https://webhook.site/something
OrganizationCacheSettings
extraCacheBudgetinteger · int64 · requiredExtra cache budget the organization can allocate among its workspaces, in bytes.
OrganizationCacheUsage
currentobject · requiredCurrent cache usage of the organization.
removalIntervalsobject[] · requiredList of cache removal intervals.
settingsobject · requiredSettings for organization cache.
OrganizationCurrentCacheUsage
cacheUsedinteger · int64 · requiredCache currently used by the organization, in bytes.
removedSinceStartinteger · int64 · requiredBytes removed since start due to insufficient cache.
removalPeriodStartstring · date-timeStart timestamp of removal period.
OrganizationPermissionAssignment
assigneeIdentifierobject · requiredIdentifier of a user or user-group.
permissionsstring[] · requiredEnum values:MANAGESELF_CREATE_TOKEN
OutlierDetectionRequest
dateAttributeobject · requiredgranularitystring · enum · requiredDate granularity for anomaly detection. Only time-based granularities are supported (HOUR, DAY, WEEK, MONTH, QUARTER, YEAR).
Enum values:HOURDAYWEEKMONTHQUARTERYEARmeasuresobject[] · minItems: 1 · requiredsensitivitystring · enum · requiredSensitivity level for outlier detection
Enum values:LOWMEDIUMHIGH
filtersarrayOptional filters to apply
PageMetadata
numberinteger · int32The number of the current page
sizeinteger · int32The size of the current page
totalElementsinteger · int32The total number of elements
totalPagesinteger · int32The total number of pages
Paging
countinteger · int32 · requiredCount of items in this page.
Example: 5offsetinteger · int32 · requiredOffset of this page.
Example: 10totalinteger · int32 · requiredCount of returnable items ignoring paging.
Example: 100
nextstringLink to next page, or null if this is last page.
Example: https://sample.gooddata.com/api/v1/actions/workspaces/sampleWorkspace/execution/collectLabelElements?label=sample.price&limit=5&offset=10
PdfTableStyle
selectorstring · requiredCSS selector where to apply given properties.
propertiesobject[]List of CSS properties.
PdfTableStyleProperty
keystring · requiredCSS property key.
valuestring · requiredCSS property value.
PdmLdmRequest
sqlsobject[]List of SQL datasets.
tableOverridesobject[](BETA) List of table overrides.
tablesobject[]List of physical database tables.
PdmSql
statementstring · requiredSQL statement.
Example: select * from abctitlestring · requiredSQL dataset title.
Example: My special dataset
columnsobject[]Columns defining SQL dataset.
PermissionsForAssignee
permissionsstring[] · requiredEnum values:EDITSHAREVIEWassigneeIdentifierobject · requiredIdentifier of a user or user-group.
PermissionsForAssigneeRule
permissionsstring[] · requiredEnum values:EDITSHAREVIEWassigneeRuleobject · requiredIdentifier of an assignee rule.
PopDataset
datasetobject · requiredReference to the date dataset to which the filter should be applied.
periodsAgointeger · int32 · requiredNumber of periods ago to calculate the previous period for.
Example: 1
PopDate
attributeobject · requiredReference to the date attribute to use.
periodsAgointeger · int32 · requiredNumber of periods ago to calculate the previous period for.
Example: 1
PopMeasureDefinition
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: previousPeriodMeasure | |
| type = object · requires: overPeriodMeasure |
Previous period type of metric.
previousPeriodMeasureobject · required
Profile
entitlementsobject[] · requiredDefines entitlements for given organization.
featuresrequiredlinksobject · requiredorganizationIdstring · requiredorganizationNamestring · requiredpermissionsstring[] · requiredEnum values:MANAGESELF_CREATE_TOKENtelemetryConfigobject · requiredTelemetry-related configuration.
userIdstring · required
namestring
QualityIssue
codestring · requiredQuality issue code
Example: SIMILAR_NAMESdetailobject · requiredDetailed information about the quality issue
idstring · requiredUnique identifier for the quality issue
objectsobject[] · requiredList of objects affected by this quality issue
severitystring · enum · requiredSeverity level
Enum values:WARNINGINFO
QualityIssueObject
idstring · requiredObject ID
Example: revenuetitlestring · requiredObject title
Example: Total Revenuetypestring · requiredObject type
Example: metricworkspaceIdstring · requiredWorkspace ID where the object belongs
Example: demo
QualityIssuesCalculationStatusResponse
statusstring · enum · requiredCurrent status of the calculation
Enum values:RUNNINGCOMPLETEDFAILEDNOT_FOUNDDISABLED
errorstringError message (available when status is FAILED or NOT_FOUND)
issuesobject[]List of quality issues (available when status is COMPLETED)
Range
fromobject · requiredmeasureobject · requiredoperatorstring · enum · requiredEnum values:BETWEENNOT_BETWEENtoobject · required
RawCustomOverride
labelsobjectMap of CustomLabels with keys used as placeholders in export result.
metricsobjectMap of CustomMetrics with keys used as placeholders in export result.
RawExportAutomationRequest
executionobject · requiredTop level executable entity. Combination of [A]ttributes, [F]ilters & [M]etrics.
fileNamestring · requiredFilename of downloaded file without extension.
Example: resultformatstring · enum · requiredRequested resulting file type.
Enum values:ARROW_FILEARROW_STREAMCSVExample: CSV
customOverrideobjectCustom cell value overrides (IDs will be replaced with specified values).
executionSettingsobjectVarious settings affecting the process of AFM execution or its result
metadataobject | null · maxLength: 15000Free-form JSON object
Example: {}
RawExportRequest
executionobject · requiredTop level executable entity. Combination of [A]ttributes, [F]ilters & [M]etrics.
fileNamestring · requiredFilename of downloaded file without extension.
Example: resultformatstring · enum · requiredRequested resulting file type.
Enum values:ARROW_FILEARROW_STREAMCSVExample: CSV
customOverrideobjectCustom cell value overrides (IDs will be replaced with specified values).
executionSettingsobjectVarious settings affecting the process of AFM execution or its result
ReadCsvFileManifestsRequestItem
fileNamestring · requiredName of the CSV file to read the manifest for.
versioninteger · int32Optional version of the file to read the manifest for. If null or not specified, the latest version is read.
ReadCsvFileManifestsResponse
manifestobject · requiredBody of the CSV manifest.
namestring · requiredName of the file in the source data source.
versioninteger · int32 · requiredVersion of the file in the source data source.
Reasoning
stepsobject[] · requiredSteps taken during processing, showing the AI's reasoning process.
answerstringFinal answer/reasoning from the use case result.
ReasoningStep
thoughtsobject[] · requiredDetailed thoughts/messages within this step.
titlestring · requiredTitle describing this reasoning step.
ReferenceIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredReference ID.
Example: customerstypestring · enum · requiredA type of the reference.
Enum values:datasetExample: DATASET
ReferenceSourceColumn
columnstring · requiredtargetobject · required
dataTypestring · enumEnum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEAN
Relative
measureobject · requiredoperatorstring · enum · requiredRelative condition operator. INCREASES_BY - the metric increases by the specified value. DECREASES_BY - the metric decreases by the specified value. CHANGES_BY - the metric increases or decreases by the specified value.
Enum values:INCREASES_BYDECREASES_BYCHANGES_BYthresholdobject · required
RelativeBoundedDateFilter
granularitystring · enum · requiredEnum values:ALL_TIME_GRANULARITYGDC.time.yearGDC.time.week_usGDC.time.week_in_yearGDC.time.week_in_quarterGDC.time.weekGDC.time.euweek_in_yearGDC.time.euweek_in_quarter
frominteger · int32tointeger · int32
ResolveSettingsRequest
settingsstring[] · requiredAn array of setting IDs to resolve.
Example: ["timezone"]
ResolvedSetting
contentobject | null · maxLength: 15000Free-form JSON object
Example: {}typestring · enumType of the setting.
Enum values:TIMEZONEACTIVE_THEMEACTIVE_COLOR_PALETTEACTIVE_LLM_ENDPOINTWHITE_LABELINGLOCALEMETADATA_LOCALEFORMAT_LOCALEExample: TIMEZONE
idstring · deprecated · requiredSetting ID. Formerly used to identify a type of a particular setting, going to be removed in a favor of setting's type.
RestApiIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredExample: sample_item.pricetypestring · requiredExample: fact
ResultCacheMetadata
afmobject · requiredTop level executable entity. Combination of [A]ttributes, [F]ilters & [M]etrics.
executionResponseobject · requiredResponse to AFM execution request body
resultSizeinteger · int64 · requiredresultSpecobject · requiredSpecifies how the result data will be formatted (
dimensions) and which additional data shall be computed (totals).
ResultDimension
headersobject[] · requiredlocalIdentifierstring · requiredLocal identifier of the dimension.
ResultDimensionHeader
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = object · requires: attributeHeader |
Measure group headers
measureGroupHeadersobject[]
RouteResult
reasoningstring · requiredExplanation why LLM picked this use case.
useCasestring · enum · requiredUse case where LLM routed based on question.
Enum values:INVALIDGENERALSEARCHCREATE_VISUALIZATIONEXTEND_VISUALIZATIONHOWTOCHANGE_ANALYSISALERT
RsaSpecification
algstring · enum · requiredEnum values:RS256RS384RS512estring · requiredkidstring · minLength: 0 · maxLength: 255 · pattern:^[^.]· requiredktystring · enum · requiredEnum values:RSAnstring · requiredusestring · enum · requiredEnum values:sig
x5cstring[]x5tstring
RulePermission
typestring · requiredType of the rule
Example: allWorkspaceUsers
permissionsobject[]Permissions granted by the rule
SavedVisualization
createdVisualizationIdstring · requiredCreated visualization ID.
savedVisualizationIdstring · requiredSaved visualization ID.
ScanRequest
scanTablesboolean · requiredA flag indicating whether the tables should be scanned.
Example: truescanViewsboolean · requiredA flag indicating whether the views should be scanned.
Example: trueseparatorstring · requiredA separator between prefixes and the names.
Example: __
schematastring[]What schemata will be scanned.
Example: ["tpch","demo"]tablePrefixstringTables starting with this prefix will be scanned. The prefix is then followed by the value of
separatorparameter. Given the table prefix isout_tableand separator is__, the table with name likeout_table__customerswill be scanned.Example: out_tableviewPrefixstringViews starting with this prefix will be scanned. The prefix is then followed by the value of
separatorparameter. Given the view prefix isout_viewand separator is__, the table with name likeout_view__us_customerswill be scanned.Example: out_view
ScanSqlRequest
sqlstring · requiredSQL query to be analyzed.
Example: SELECT a.special_value as result FROM tableA a
ScanSqlResponse
columnsobject[] · requiredArray of columns with types.
dataPreviewarray[]Array of rows where each row is another array of string values.
SearchRelationshipObject
sourceObjectIdstring · requiredSource object ID.
sourceObjectTitlestring · requiredSource object title.
sourceObjectTypestring · requiredSource object type, e.g. dashboard.
sourceWorkspaceIdstring · requiredSource workspace ID. If relationship is dashboard->visualization, this is the workspace where the dashboard is located.
targetObjectIdstring · requiredTarget object ID.
targetObjectTitlestring · requiredTarget object title.
targetObjectTypestring · requiredTarget object type, e.g. visualization.
targetWorkspaceIdstring · requiredTarget workspace ID. If relationship is dashboard->visualization, this is the workspace where the visualization is located.
SearchRequest
questionstring · maxLength: 1000 · requiredKeyword/sentence is input for search.
deepSearchbooleanTurn on deep search. If true, content of complex objects will be searched as well, e.g. metrics in visualizations.
Default: falseincludeHiddenbooleanIf true, includes hidden objects in search results. If false (default), excludes objects where isHidden=true.
Default: falselimitinteger · int32Maximum number of results to return. There is a hard limit and the actual number of returned results may be lower than what is requested.
Default: 10objectTypesstring[]List of object types to search for.
Enum values:attributemetricfactlabeldatedatasetvisualizationdashboardrelevantScoreThresholdnumber · doubleScore, above which we return found objects. Below this score objects are not relevant.
Default: 0.3titleToDescriptorRationumber · doubleTemporary for experiments. Ratio of title score to descriptor score.
Default: 0.7
SearchResult
reasoningstring · requiredDEPRECATED: Use top-level reasoning.steps instead. If something is not working properly this field will contain explanation.
relationshipsobject[] · requiredresultsobject[] · required
SearchResultObject
idstring · requiredObject ID.
titlestring · requiredObject title.
typestring · requiredObject type, e.g. dashboard.
workspaceIdstring · requiredWorkspace ID.
createdAtstring · date-timeTimestamp when object was created.
descriptionstringObject description.
isHiddenbooleanIf true, this object is hidden from AI search results by default.
modifiedAtstring · date-timeTimestamp when object was last modified.
scorenumber · floatResult score calculated by a similarity search algorithm (cosine_distance).
scoreDescriptornumber · floatResult score for descriptor containing(now) description and tags.
scoreExactMatchinteger · int32Result score for exact match(id/title). 1/1000. Other scores are multiplied by this.
scoreTitlenumber · floatResult score for object title.
tagsstring[] · uniquevisualizationUrlstringIf the object is visualization, this field defines the type of visualization.
Settings
exportInfobooleanIf true, the export will contain the information about the export – exported date, filters, etc. Works only with
visualizationObject. (XLSX, PDF)Example: trueDefault: falsemergeHeadersbooleanMerge equal headers in neighbouring cells. (XLSX)
Example: truepageOrientationstring · enumSet page orientation. (PDF)
Enum values:PORTRAITLANDSCAPEDefault: PORTRAITpageSizestring · enumSet page size. (PDF)
Enum values:A3A4LETTERDefault: A4
pdfPageSizestring · deprecated · requiredPage size and orientation. (PDF)
Example: a4 landscapepdfTableStyleobject[] · deprecated · requiredCustom CSS styles for the table. (PDF, HTML)
Example: [{"properties":[{"key":"font-size","value":"30px"}],"selector":"th"}]pdfTopLeftContentstring · deprecated · requiredTop left header content. (PDF)
Example: GoodpdfTopRightContentstring · deprecated · requiredTop right header content. (PDF)
Example: MorningshowFiltersboolean · deprecated · requiredPrint applied filters on top of the document. (PDF/HTML when visualizationObject is given)
Example: false
SlidesExportRequest
fileNamestring · requiredFile name to be used for retrieving the pdf document.
Example: filenameformatstring · enum · requiredRequested resulting file type.
Enum values:PDFPPTXExample: PDF
dashboardIdstringDashboard identifier
Example: 761cd28b-3f57-4ac9-bbdc-1c552cc0d1d0metadataobject | null · maxLength: 15000Free-form JSON object
Example: {}templateIdstring | null · maxLength: 255Export template identifier.
visualizationIdsstring[] · maxItems: 1 · uniqueList of visualization ids to be exported. Note that only one visualization is currently supported.
widgetIdsstring[] · maxItems: 1 · uniqueList of widget identifiers to be exported. Note that only one widget is currently supported.
Smtp
typestring · enum · requiredThe destination type.
Enum values:SMTP
fromEmailstring · emailE-mail address to send notifications from.
Default: no-reply@gooddata.comfromEmailNamestringAn optional e-mail name to send notifications from.
Default: GoodDatahoststringThe SMTP server address.
passwordstring · writeOnlyThe SMTP server password.
portinteger · enum · int32The SMTP server port.
Enum values:252525465587usernamestringThe SMTP server username.
SortKey
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: attribute | |
| type = object · requires: value | |
| type = object · requires: total |
Sorting rule for sorting by attribute value in current dimension.
attributeobject · required
SqlColumn
dataTypestring · enum · requiredColumn type
Enum values:INTSTRINGDATENUMERICTIMESTAMPTIMESTAMP_TZBOOLEANExample: INTnamestring · requiredColumn name
Example: customer_id
descriptionstringColumn description/comment from database
Example: Customer unique identifier
SwitchIdentityProviderRequest
idpIdstring · requiredIdentity provider ID to set as active for the organization.
Example: my-idp-123
TableOverride
columnsobject[] · requiredAn array of column overrides
pathstring[] · requiredPath for the table.
Example: ["schema","table_name"]
TableWarning
columnsobject[] · requirednamestring · requiredTable name.
messagestringWarning message related to the table.
TabularExportRequest
fileNamestring · requiredFilename of downloaded file without extension.
Example: resultformatstring · enum · requiredExpected file format.
Enum values:CSVXLSXHTMLPDFExample: CSV
customOverrideobjectCustom cell value overrides (IDs will be replaced with specified values).
executionResultstringExecution result identifier.
Example: ff483727196c9dc862c7fd3a5a84df55c96d61a4metadataobject | null · maxLength: 15000Free-form JSON object
Example: {}relatedDashboardIdstringAnalytical dashboard identifier. Optional identifier, which informs the system that the export is related to a specific dashboard.
Example: 761cd28b-3f57-4ac9-bbdc-1c552cc0d1d0settingsobjectAdditional settings.
visualizationObjectstringVisualization object identifier. Alternative to executionResult property.
Example: f7c359bc-c230-4487-b15b-ad9685bcb537visualizationObjectCustomFiltersobject[]Optional custom filters (as array of IFilter objects defined in UI SDK) to be applied when visualizationObject is given. Those filters override the original filters defined in the visualization.
Example: [{"negativeAttributeFilter":{"displayForm":{"identifier":{"id":"products.category","type":"label"}},"notIn":{"values":["Books"]}}}]
TelemetryConfig
contextobject · requiredThe telemetry context.
servicesobject · requiredAvailable telemetry services.
TelemetryContext
deploymentIdstring · requiredIdentification of the deployment.
organizationHashstring · requiredOrganization hash.
userHashstring · requiredUser hash.
TelemetryServices
amplitudeobjectAmplitude service.
matomoobjectMatomo service.
openTelemetryobjectOpenTelemetry service.
TestDefinitionRequest
typestring · enum · requiredType of database, where test should connect to.
Enum values:POSTGRESQLREDSHIFTVERTICASNOWFLAKEADSBIGQUERYMSSQLPRESTOExample: POSTGRESQL
clientIdstringId for client based authentication for data sources which supports it.
clientSecretstringSecret for client based authentication for data sources which supports it.
parametersobject[]passwordstringDatabase user password.
Example: admin123privateKeystringPrivate key for data sources which supports key-pair authentication.
privateKeyPassphrasestringPassphrase for a encrypted version of a private key.
schemastringDatabase schema.
Example: publictokenstringSecret for token based authentication for data sources which supports it.
urlstringURL to database in JDBC format, where test should connect to.
Example: jdbc:postgresql://localhost:5432/db_nameusernamestringDatabase user name.
Example: dbadmin
TestDestinationRequest
destinationrequired
externalRecipientsarray | null · maxItems: 1 · uniqueExternal recipients of the test result.
TestQueryDuration
simpleSelectinteger · int32 · requiredField containing duration of a test select query on a data source. In milliseconds.
Example: 562
createCacheTableinteger · int32Field containing duration of a test 'create table as select' query on a datasource. In milliseconds. The field is omitted if a data source doesn't support caching.
Example: 235
TestRequest
clientIdstringId for client based authentication for data sources which supports it.
clientSecretstringSecret for client based authentication for data sources which supports it.
parametersobject[]passwordstringDatabase user password.
Example: admin123privateKeystringPrivate key for data sources which supports key-pair authentication.
privateKeyPassphrasestringPassphrase for a encrypted version of a private key.
schemastringDatabase schema.
Example: publictokenstringSecret for token based authentication for data sources which supports it.
urlstringURL to database in JDBC format, where test should connect to.
Example: jdbc:postgresql://localhost:5432/db_nameusernamestringDatabase user name.
Example: dbadmin
TestResponse
successfulboolean · requiredA flag indicating whether test passed or not.
Example: true
errorstringField containing more details in case of a failure. Details are available to a privileged user only.
Example: Connection exception: Failed to initialize pool: FATAL: password authentication failed for user "user"queryDurationMillisobjectA structure containing duration of the test queries run on a data source. It is omitted if an error happens.
Total
functionstring · enum · requiredAggregation function to compute the total.
Enum values:SUMMINMAXAVGMEDNATExample: SUMlocalIdentifierstring · requiredTotal identification within this request. Used e.g. in sorting by a total.
Example: firstTotalmetricstring · requiredThe metric for which the total will be computed
Example: metric_1totalDimensionsobject[] · required
TotalDimension
dimensionIdentifierstring · pattern:^[.a-zA-Z0-9_-]+$· requiredAn identifier of a dimension for which the total will be computed.
Example: firstDimensiontotalDimensionItemsstring[] · requiredList of dimension items which will be used for total computation. The total is a grand total in this dimension if the list is empty or it includes the first dimension item from the dimension definition, and its data and header will be returned in a separate
ExecutionResultGrandTotalstructure. Otherwise, it is a subtotal and the data will be integrated into the main result.Example: ["measureGroup"]
TotalExecutionResultHeader
totalHeaderobject · requiredHeader containing the information related to a subtotal.
TriggerQualityIssuesCalculationResponse
processIdstring · requiredProcess ID for tracking the calculation status
statusstring · enum · requiredCurrent status of the calculation
Enum values:RUNNINGCOMPLETEDFAILEDDISABLED
UploadFileResponse
locationstring · requiredLocation to use when referencing the uploaded file in subsequent requests.
UserAssignee
idstring · required
emailstringUser email address
Example: user@example.comnamestringUser name
Example: John Wick
UserGroupPermission
idstring · required
namestringName of the user group
Example: adminspermissionsobject[]Permissions granted to the user group
UserManagementDataSourcePermissionAssignment
idstring · requiredId of the datasource
permissionsstring[] · requiredEnum values:MANAGEUSE
namestring · readOnlyName of the datasource
UserManagementUserGroups
totalCountinteger · int32 · requiredTotal number of groups
userGroupsobject[] · required
UserManagementUserGroupsItem
dataSourcesobject[] · requiredidstring · requiredorganizationAdminboolean · requiredIs group organization admin
Example: falseuserCountinteger · int32 · requiredThe number of users belonging to the group
workspacesobject[] · required
namestringGroup name
Example: admins
UserManagementUsers
totalCountinteger · int32 · requiredThe total number of users is based on applied filters.
usersobject[] · required
UserManagementUsersItem
dataSourcesobject[] · requiredidstring · requiredorganizationAdminboolean · requiredIs user organization admin
Example: falseuserGroupsobject[] · requiredworkspacesobject[] · required
emailstringUser email address
Example: user@example.comnamestringUser name
Example: John Wick
UserManagementWorkspacePermissionAssignment
hierarchyPermissionsstring[] · requiredEnum values:MANAGEANALYZEEXPORTEXPORT_TABULAREXPORT_PDFCREATE_AUTOMATIONUSE_AI_ASSISTANTCREATE_FILTER_VIEWidstring · requiredpermissionsstring[] · requiredEnum values:MANAGEANALYZEEXPORTEXPORT_TABULAREXPORT_PDFCREATE_AUTOMATIONUSE_AI_ASSISTANTCREATE_FILTER_VIEW
namestring · readOnly
UserPermission
idstring · required
emailstringUser email address
Example: user@example.comnamestringName of user
Example: John Wickpermissionsobject[]Permissions granted to the user
ValidateLLMEndpointByIdRequest
baseUrlstringBase URL for the LLM endpoint validation
llmModelstringLLM model for the LLM endpoint validation
llmOrganizationstringOrganization name for the LLM endpoint validation
providerstringProvider for the LLM endpoint validation
tokenstringToken for the LLM endpoint validation
ValidateLLMEndpointRequest
providerstring · requiredProvider for the LLM endpoint validation
tokenstring · requiredToken for the LLM endpoint validation
baseUrlstringBase URL for the LLM endpoint validation
llmModelstringLLM model for the LLM endpoint validation
llmOrganizationstringOrganization name for the LLM endpoint validation
ValidateLLMEndpointResponse
messagestring · requiredAdditional message about the LLM endpoint validation
successfulboolean · requiredWhether the LLM endpoint validation was successful
VisibleFilter
isAllTimeDateFilterbooleanIndicates if the filter is an all-time date filter. Such a filter is not included in report computation, so there is no filter with the same 'localIdentifier' to be found. In such cases, this flag is used to inform the server to not search for the filter in the definitions and include it anyways.
Default: falselocalIdentifierstringtitlestring
VisualExportRequest
dashboardIdstring · requiredDashboard identifier
Example: 761cd28b-3f57-4ac9-bbdc-1c552cc0d1d0fileNamestring · requiredFile name to be used for retrieving the pdf document.
Example: filename
metadataobjectMetadata definition in free-form JSON format.
Example: {}
Webhook
typestring · enum · requiredThe destination type.
Enum values:WEBHOOK
hasTokenboolean | null · maxLength: 10000 · readOnlyFlag indicating if webhook has a token.
tokenstring | null · maxLength: 10000 · writeOnlyBearer token for the webhook.
Example: secreturlstring · maxLength: 255 · pattern:(?=https?\://.*)(?=h…The webhook URL.
Example: https://webhook.site/something
WebhookAutomationInfo
dashboardURLstring · requiredidstring · requiredisCustomDashboardURLboolean · required
dashboardTitlestringtitlestring
WebhookMessage
dataobject · requiredtimestampstring · date-time · requiredtypestring · enum · requiredEnum values:automation-task.completedautomation-task.limit-exceeded
WebhookMessageData
automationobject · required
alertobjectdashboardTabularExportsobject[]detailsobjectfiltersobject[]imageExportsobject[]notificationSourcestringrawExportsobject[]recipientsobject[]remainingActionCountinteger · int32slidesExportsobject[]tabularExportsobject[]visualExportsobject[]
WorkspaceCacheUsage
currentobject · requiredCurrent cache usage of the workspace.
removalIntervalsobject[] · requiredList of cache removal intervals for workspace.
settingsobject · requiredCache settings for the workspace.
WorkspaceCurrentCacheUsage
cacheAvailableinteger · int64 · requiredCache available for the workspace.
cacheUsedinteger · int64 · requiredCache used by the workspace.
removalPeriodStartstring · date-time · requiredStart timestamp of removal period for the workspace.
removedSinceStartinteger · int64 · requiredBytes removed since start due to insufficient cache for the workspace.
WorkspaceDataSource
idstring · requiredThe ID of the used data source.
Example: snowflake.instance.1
schemaPathstring[]The full schema path as array of its path parts. Will be rendered as subPath1.subPath2...
WorkspaceIdentifier
idstring · pattern:^(?!\.)[.A-Za-z0-9_-…· requiredIdentifier of the workspace.
Example: alpha.salestypestring · enum · requiredA type.
Enum values:workspaceExample: workspace
WorkspacePermissionAssignment
assigneeIdentifierobject · requiredIdentifier of a user or user-group.
hierarchyPermissionsstring[]Enum values:MANAGEANALYZEEXPORTEXPORT_TABULAREXPORT_PDFCREATE_AUTOMATIONUSE_AI_ASSISTANTCREATE_FILTER_VIEWpermissionsstring[]Enum values:MANAGEANALYZEEXPORTEXPORT_TABULAREXPORT_PDFCREATE_AUTOMATIONUSE_AI_ASSISTANTCREATE_FILTER_VIEW
WorkspaceUser
idstring · required
emailstringUser email address
Example: user@example.comnamestringUser name
Example: John Wick
WorkspaceUserGroups
totalCountinteger · int32 · requiredTotal number of groups
userGroupsobject[] · required