Forms / Get one

Return specific form by id.

Route: /api/{tenant:minlength(2)}/v{version:apiVersion}/forms/{id}

Method: GET

Authorisation: Minimum role: USER

Request Arguments
Name Type Source
idInt32

  Request body example

Response object

Response status: 200 (OK)

Response type: DTO_form

Wrapper: DTO_response_wrap

Other response statuses: 400 (BadRequest), 403 (Forbidden)

  Response body example

DTO_form
NameTypeReadOnlyDescription
group_accessDTO_group_access[]Group access
sys_tagsDTO_reference[]Label can be used on POST/PUT to create new tags
collect_to_listDTO_referenceCollect to list
collect_to_groupDTO_referenceCollect to group
modulesDTO_form_module[]Modules
logicsDTO_form_logic[]Logics
languageDTO_referenceLanguage
created_byDTO_reference_userReadOnlyCreated by
last_updated_byDTO_reference_userReadOnlyLast updated by
idInt32ReadOnlyLeave empty on input
highest_group_permissionENUM group_permissionReadOnlyHighest group permission
nameStringName
unique_keyStringUnique key
privacyENUM privacyPrivacy
collect_typeENUM form_collect_typeCollect type
display_typeENUM form_display_typeDisplay type
submit_textStringSubmit text
ticket_subjectStringTicket subject
primary_colorStringPrimary color
createdDateTimeReadOnlyCreated
last_updatedDateTimeReadOnlyLast updated
DTO_group_access
NameTypeReadOnlyDescription
permissionENUM group_permissionPermission
idInt32Id
labelObjectReadOnlyLabel
DTO_reference
NameTypeReadOnlyDescription
idInt32The id of the reference
labelObjectReadOnlyName/Label from referenced object.
DTO_form_module
NameTypeReadOnlyDescription
module_fieldDTO_form_module_fieldModule field
typeENUM form_module_typeType
text_primaryStringText primary
text_secondaryStringText secondary
enabledBooleanEnabled
DTO_form_module_field
NameTypeReadOnlyDescription
idInt32Id
labelStringLabel
requiredBooleanRequired
DTO_form_logic
NameTypeReadOnlyDescription
triggersDTO_form_logic_trigger[]Triggers
actionDTO_form_logic_actionAction
logic_operatorENUM form_logic_operatorLogic operator
DTO_form_logic_trigger
NameTypeReadOnlyDescription
module_fieldDTO_referenceModule field
field_valuesDTO_reference[]Field values
DTO_form_logic_action
NameTypeReadOnlyDescription
forward_to_module_fieldDTO_referenceForward to module field
forward_to_formDTO_referenceForward to form
hide_module_fieldsDTO_reference[]Hide module fields
show_module_fieldsDTO_reference[]Show module fields
DTO_reference_user
NameTypeReadOnlyDescription
profile_picStringReadOnlyProfile pic
emailStringReadOnlyEmail
idInt32Id
labelObjectReadOnlyLabel
ENUM group_permission
ValueNameDescription
0UNKNOWNUNKNOWN
1READRead only
2EDITEdit
3FULLFull
ENUM form_module_type
ValueNameDescription
0UNKNOWNUNKNOWN
1HEADERHEADER
2INFORMATIONINFORMATION
3FIELDFIELD
4LINE_SEPARATORLINE_SEPARATOR
5PAGE_SEPARATORPAGE_SEPARATOR
6SUBMIT_MESSAGESUBMIT_MESSAGE
ENUM form_logic_operator
ValueNameDescription
0UNKNOWNUNKNOWN
1ANDAND
2OROR
ENUM privacy
ValueNameDescription
0UNKNOWNUNKNOWN
1PRIVATEPRIVATE
2PUBLICPUBLIC
ENUM form_collect_type
ValueNameDescription
0UNKNOWNUNKNOWN
1TICKETTICKET
2LISTLIST
ENUM form_display_type
ValueNameDescription
0UNKNOWNUNKNOWN
1CLASSICCLASSIC
2CARDCARD