Export form definitions by tenant.​
No parameters required.
Query Parameters
- offset int64
Offset
Integer specifying the offset of the first result from the beginning of the collection. The standard syntax described in V3 API Standard Collection Parameters. The offset value is record-based, not page-based, and the index starts at 0.
Example: 250 - limit int64
Possible values:
<= 250 characters
Default value:
250
Limit
Integer specifying the maximum number of records to return in a single API call. The standard syntax described in V3 API Standard Collection Parameters. If it is not specified, a default limit is used.
Example: 250 - filters string
Filters
Filter results using the standard syntax described in V3 API Standard Collection Parameters Filtering is supported for the following fields and operators: name: eq, gt, sw, in description: eq, gt, sw, in created: eq, gt, sw, in modified: eq, gt, sw, in
Example: name sw "my form" - sorters string
Default value:
name
Sorters
Item will be sorted in the returned array if the sorters expression evaluates to true for that item. The standard syntax described in V3 API Standard Collection Parameters. Sorting is supported for the following fields: name description created modified
Example: name
- 200
- 400
- 401
- 403
- 429
- 500
Returns a list of form definitions by tenant
- application/json
- Schema
- Example (from schema)
Schema
- count int64
Count number of Results
results object[]
Results holds a list of FormDefinitionResponse items
created date-timeCreated is the date the form definition was created
description stringDescription is the form definition description
formConditions object[]
FormConditions is the conditional logic that modify the form dynamically modify the form as the recipient is interacting out the form
effects object[]
Effects is a list of effects
config object
Config is a arbitrary map that holds a configuration based on EffectType
effectType stringPossible values: [
HIDE
,SHOW
,DISABLE
,ENABLE
,REQUIRE
,OPTIONAL
,SUBMIT_MESSAGE
,SUBMIT_NOTIFICATION
,SET_DEFAULT_VALUE
]EffectType is the type of effect to perform when the conditions are evaluated for this logic block HIDE ConditionEffectTypeHide ConditionEffectTypeHide disables validations SHOW ConditionEffectTypeShow ConditionEffectTypeShow enables validations DISABLE ConditionEffectTypeDisable ConditionEffectTypeDisable disables validations ENABLE ConditionEffectTypeEnable ConditionEffectTypeEnable enables validations REQUIRE ConditionEffectTypeRequire OPTIONAL ConditionEffectTypeOptional SUBMIT_MESSAGE ConditionEffectTypeSubmitMessage SUBMIT_NOTIFICATION ConditionEffectTypeSubmitNotification SET_DEFAULT_VALUE ConditionEffectTypeSetDefaultValue ConditionEffectTypeSetDefaultValue is ignored on purpose
ruleOperator stringPossible values: [
AND
,OR
]RuleOperator is a ConditionRuleLogicalOperatorType value AND ConditionRuleLogicalOperatorTypeAnd OR ConditionRuleLogicalOperatorTypeOr
rules object[]
Rules is a list of rules
operator stringPossible values: [
EQ
,NE
,CO
,NOT_CO
,IN
,NOT_IN
,EM
,NOT_EM
,SW
,NOT_SW
,EW
,NOT_EW
]Operator is a ConditionRuleComparisonOperatorType value EQ ConditionRuleComparisonOperatorTypeEquals ConditionRuleComparisonOperatorTypeEquals is a comparison operator, the source and target are compared for equality NE ConditionRuleComparisonOperatorTypeNotEquals ConditionRuleComparisonOperatorTypeNotEquals is a comparison operator, the source and target are compared for the opposite of equality CO ConditionRuleComparisonOperatorTypeContains ConditionRuleComparisonOperatorTypeContains is a comparison operator, the source is searched to see if it contains the value NOT_CO ConditionRuleComparisonOperatorTypeNotContains IN ConditionRuleComparisonOperatorTypeIncludes ConditionRuleComparisonOperatorTypeIncludes is a comparison operator, the source will be searched if it equals any of the values NOT_IN ConditionRuleComparisonOperatorTypeNotIncludes EM ConditionRuleComparisonOperatorTypeEmpty NOT_EM ConditionRuleComparisonOperatorTypeNotEmpty SW ConditionRuleComparisonOperatorTypeStartsWith ConditionRuleComparisonOperatorTypeStartsWith checks if a string starts with another substring of the same string, this operator is case-sensitive NOT_SW ConditionRuleComparisonOperatorTypeNotStartsWith EW ConditionRuleComparisonOperatorTypeEndsWith ConditionRuleComparisonOperatorTypeEndsWith checks if a string ends with another substring of the same string, this operator is case-sensitive NOT_EW ConditionRuleComparisonOperatorTypeNotEndsWith
source stringSource, if the sourceType is ConditionRuleSourceTypeInput then the source type is the name of the form input to accept. While if the sourceType is ConditionRuleSourceTypeElement then source is the name of a technical key of an element to retrieve its value
sourceType stringPossible values: [
INPUT
,ELEMENT
]SourceType defines what type of object is being selected. Either a reference to a form input (by input name), or a form element (by technical key) INPUT ConditionRuleSourceTypeInput ELEMENT ConditionRuleSourceTypeElement
valueValue is the value based on the ValueType
valueType stringPossible values: [
STRING
,STRING_LIST
,INPUT
,ELEMENT
,LIST
,BOOLEAN
]ValueType is a ConditionRuleValueType type STRING ConditionRuleValueTypeString ConditionRuleValueTypeString the value field is a static string STRING_LIST ConditionRuleValueTypeStringList ConditionRuleValueTypeStringList the value field is an array of string values INPUT ConditionRuleValueTypeInput ConditionRuleValueTypeInput the value field is a reference to a form input by ELEMENT ConditionRuleValueTypeElement ConditionRuleValueTypeElement the value field is a reference to form element (by technical key) LIST ConditionRuleValueTypeList BOOLEAN ConditionRuleValueTypeBoolean
formElements object[]
FormElements is a list of nested form elements
config object
Config is a config object
elementType stringPossible values: [
TEXT
,TOGGLE
,TEXTAREA
,HIDDEN
,PHONE
,EMAIL
,SELECT
,DATE
,SECTION
,COLUMNS
]ElementType is a FormElementType value TEXT FormElementTypeText TOGGLE FormElementTypeToggle TEXTAREA FormElementTypeTextArea HIDDEN FormElementTypeHidden PHONE FormElementTypePhone EMAIL FormElementTypeEmail SELECT FormElementTypeSelect DATE FormElementTypeDate SECTION FormElementTypeSection COLUMNS FormElementTypeColumns
id stringID is a form element identifier
key stringKey is the technical key
validations objectFormElementValidationsSet is a set of FormElementValidation items
formInput object[]
FormInput is a list of form inputs that are required when creating a form-instance object
description stringDescription is the description for this form input value
id stringID is a unique identifier
label stringLabel is the name for this form input value
type stringPossible values: [
STRING
]Type is a FormDefinitionInputType value STRING FormDefinitionInputTypeString
id stringFormDefinitionID is a unique guid identifying this form definition
modified date-timeModified is the last date the form definition was modified
name stringName is the form definition name
owner object
id stringID is a unique identifier
type stringPossible values: [
IDENTITY
]Type is a FormOwnerType value IDENTITY FormOwnerTypeIdentity
usedBy object[]
UsedBy is a list of objects where when any system uses a particular form it reaches out to the form service to record it is currently being used
id stringID is a unique identifier
type stringPossible values: [
WORKFLOW
,SOURCE
]Type is a FormUsedByType value WORKFLOW FormUsedByTypeWorkflow SOURCE FormUsedByTypeSource
{
"count": 1,
"results": [
{
"created": "2023-07-12T20:14:57.74486Z",
"description": "My form description",
"formConditions": [
{
"effects": [
{
"config": {},
"effectType": "HIDE"
}
],
"ruleOperator": "AND",
"rules": [
{
"operator": "EQ",
"source": "department",
"sourceType": "ELEMENT",
"value": "Engineering",
"valueType": "STRING"
}
]
}
],
"formElements": [
{
"config": {
"label": "Department"
},
"elementType": "TEXT",
"id": "00000000-0000-0000-0000-000000000000",
"key": "department",
"validations": [
{
"validationType": "REQUIRED"
}
]
}
],
"formInput": [
{
"description": "A single dynamic scalar value (i.e. number, string, date, etc.) that can be passed into the form for use in conditional logic",
"id": "00000000-0000-0000-0000-000000000000",
"label": "input1",
"type": "STRING"
}
],
"id": "00000000-0000-0000-0000-000000000000",
"modified": "2023-07-12T20:14:57.74486Z",
"name": "My form",
"owner": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "IDENTITY"
},
"usedBy": [
{
"id": "00000000-0000-0000-0000-000000000000",
"type": "WORKFLOW"
}
]
}
]
}
An error with the request occurred
- application/json
- Schema
- Example (from schema)
Schema
- detailCode string
messages object[]
locale stringLocale is the current Locale
localeOrigin stringLocaleOrigin holds possible values of how the locale was selected
text stringText is the actual text of the error message
- statusCode int64
- trackingId string
{
"detailCode": "string",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "This is an error"
}
],
"statusCode": 0,
"trackingId": "string"
}
An error with the authorization occurred
- application/json
- Schema
- Example (from schema)
Schema
- detailCode string
messages object[]
locale stringLocale is the current Locale
localeOrigin stringLocaleOrigin holds possible values of how the locale was selected
text stringText is the actual text of the error message
- statusCode int64
- trackingId string
{
"detailCode": "string",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "This is an error"
}
],
"statusCode": 0,
"trackingId": "string"
}
An error with the user permissions occurred
- application/json
- Schema
- Example (from schema)
Schema
- detailCode string
messages object[]
locale stringLocale is the current Locale
localeOrigin stringLocaleOrigin holds possible values of how the locale was selected
text stringText is the actual text of the error message
- statusCode int64
- trackingId string
{
"detailCode": "string",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "This is an error"
}
],
"statusCode": 0,
"trackingId": "string"
}
Too many requests
- application/json
- Schema
- Example (from schema)
Schema
- detailCode string
DetailCode is the text of the status code returned
messages object[]
locale stringLocale is the current Locale
localeOrigin stringLocaleOrigin holds possible values of how the locale was selected
text stringText is the actual text of the error message
- trackingId string
TrackingID is the request tracking unique identifier
{
"detailCode": "Internal Server Error",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "This is an error"
}
],
"trackingId": "9cd03ef80e6a425eb6b11bdbb057cdb4"
}
An internal server error occurred
- application/json
- Schema
- Example (from schema)
Schema
- detailCode string
messages object[]
locale stringLocale is the current Locale
localeOrigin stringLocaleOrigin holds possible values of how the locale was selected
text stringText is the actual text of the error message
- statusCode int64
- trackingId string
{
"detailCode": "string",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "This is an error"
}
],
"statusCode": 0,
"trackingId": "string"
}