You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
"webforms_instance_write": "Create instance and modify instance configuration"
585
586
}
@@ -914,8 +915,24 @@
914
915
"description": "The request body for the `Instances::createInstance` endpoint.",
915
916
"properties": {
916
917
"formValues": {
917
-
"$ref": "#/definitions/WebFormValues",
918
-
"description": "Key-value pairs used to prefill fields in the web form instance. The keys correspond to the values of the `publishedComponentNames` object on the `WebForm` (configuration) object.\n\nFor keys of type TextBox, Email, Date, Select, and RadioButtonGroup, the value should be a string. For keys of type Number, the value should be a number. For keys of type of CheckboxGroup, the value should be an array of strings.\n\nFor example, a web form configuration might have the following properties indicated by the `publishedComponentNames` object:\n```\n\"publishedComponentNames\": {\n \"Signer_name\": \"TextBox\",\n \"Signer_email\": \"Email\",\n \"Dropdown\": \"Select\",\n \"Hobbies\": \"CheckboxGroup\"\n}\n```\n\nThen, this property might be:\n```\n{\n \"Signer_name\": \"Francis Beagle\",\n \"Signer_email\": \"francis@example.com\",\n \"Hobbies\": [\"walking\", \"napping\"]\n}\n```\n\nNote that you do not have to include values for every component. This property is **optional.**"
918
+
"type": "object",
919
+
"description": "Key-value pairs used to prefill fields in the web form instance. The keys correspond to the values of the `publishedComponentNames` object on the `WebForm` (configuration) object.\n\nFor keys of type TextBox, Email, Date, Select, and RadioButtonGroup, the value should be a string. For keys of type Number, the value should be a number. For keys of type of CheckboxGroup, the value should be an array of strings.\n\nFor example, a web form configuration might have the following properties indicated by the `publishedComponentNames` object:\n```\n\"publishedComponentNames\": {\n \"Signer_name\": \"TextBox\",\n \"Signer_email\": \"Email\",\n \"Dropdown\": \"Select\",\n \"Hobbies\": \"CheckboxGroup\"\n}\n```\n\nThen, this property might be:\n```\n{\n \"Signer_name\": \"Francis Beagle\",\n \"Signer_email\": \"francis@example.com\",\n \"Hobbies\": [\"walking\", \"napping\"]\n}\n```\n\nNote that you do not have to include values for every component. This property is **optional.**",
920
+
"additionalProperties": {},
921
+
"example": {
922
+
"Textbox_Name": "First Last",
923
+
"Email_primary": "example@example.com",
924
+
"Date_birth": "2020-01-01",
925
+
"Number_age": 52,
926
+
"Select_state": "California",
927
+
"Radio_Gender": "Female",
928
+
"Checkbox_hobbies": [
929
+
"singing",
930
+
"dancing"
931
+
],
932
+
"ID_card_attachment": {
933
+
"documentName": "id_card.pdf"
934
+
}
935
+
}
919
936
},
920
937
"clientUserId": {
921
938
"$ref": "#/definitions/ClientUserId",
@@ -949,6 +966,10 @@
949
966
"$ref": "#/definitions/SendOption",
950
967
"description": ""
951
968
},
969
+
"brandId": {
970
+
"$ref": "#/definitions/BrandId",
971
+
"description": ""
972
+
},
952
973
"recipients": {
953
974
"description": "",
954
975
"type": "array",
@@ -1133,8 +1154,28 @@
1133
1154
"description": "Metadata associated with the web form instance."
1134
1155
},
1135
1156
"formValues": {
1136
-
"$ref": "#/definitions/WebFormValues",
1137
-
"description": "Key-value pairs that represent the current values of the fields in the web form instance. The keys correspond to the `componentName` values of the `formContent.components` object on the `WebForm` (configuration) object. See [Form field definitions](/docs/web-forms-api/plan-integration/retrieve-configuration-details/#form-field-definitions) for more information.\n\nSee [Request that retrieves web form instance values](/docs/web-forms-api/plan-integration/retrieve-submitted-values/#request-that-retrieves-web-form-instance-values) for an example of a `formValues` object returned by this request.\n"
1157
+
"type": "object",
1158
+
"description": "Key-value pairs that represent the current values of the fields in the web form instance. The keys correspond to the `componentName` values of the `formContent.components` object on the `WebForm` (configuration) object. See [Form field definitions](/docs/web-forms-api/plan-integration/retrieve-configuration-details/#form-field-definitions) for more information.\n\nSee [Request that retrieves web form instance values](/docs/web-forms-api/plan-integration/retrieve-submitted-values/#request-that-retrieves-web-form-instance-values) for an example of a `formValues` object returned by this request.\n",
1159
+
"additionalProperties": {},
1160
+
"example": {
1161
+
"Textbox_Name": "First Last",
1162
+
"Email_primary": "example@example.com",
1163
+
"Date_birth": "2020-01-01",
1164
+
"Number_age": 52,
1165
+
"Select_state": "California",
1166
+
"Radio_Gender": "Female",
1167
+
"Checkbox_hobbies": [
1168
+
"singing",
1169
+
"dancing"
1170
+
],
1171
+
"ID_card_attachment": {
1172
+
"documentName": "id_card.pdf"
1173
+
}
1174
+
}
1175
+
},
1176
+
"brandId": {
1177
+
"$ref": "#/definitions/BrandId",
1178
+
"description": ""
1138
1179
},
1139
1180
"recipients": {
1140
1181
"description": "",
@@ -1147,6 +1188,9 @@
1147
1188
},
1148
1189
"instanceRecipientStatus": {
1149
1190
"$ref": "#/definitions/InstanceRecipientStatus"
1191
+
},
1192
+
"roleName": {
1193
+
"$ref": "#/definitions/RoleName"
1150
1194
}
1151
1195
}
1152
1196
}
@@ -1268,28 +1312,6 @@
1268
1312
"x-ds-definition-name": "WebForm",
1269
1313
"x-ms-summary": "A web form configuration."
1270
1314
},
1271
-
"WebFormValues": {
1272
-
"type": "object",
1273
-
"description": "Key-value pairs of data used to create a form instance.",
1274
-
"additionalProperties": {},
1275
-
"example": {
1276
-
"Textbox_Name": "First Last",
1277
-
"Email_primary": "example@example.com",
1278
-
"Date_birth": "2020-01-01",
1279
-
"Number_age": 52,
1280
-
"Select_state": "California",
1281
-
"Radio_Gender": "Female",
1282
-
"Checkbox_hobbies": [
1283
-
"singing",
1284
-
"dancing"
1285
-
],
1286
-
"ID_card_attachment": {
1287
-
"documentName": "id_card.pdf"
1288
-
}
1289
-
},
1290
-
"x-ds-definition-name": "WebFormValues",
1291
-
"x-ms-summary": "Key-value pairs of data used to create a form instance."
1292
-
},
1293
1315
"WebFormState": {
1294
1316
"type": "string",
1295
1317
"description": "The state of the form content",
@@ -1744,4 +1766,4 @@
1744
1766
"description": "<ds-inlinemessage>The Web Forms API is available in all developer accounts, but only in certain production account plans. Contact \n[DocuSign Support](https://support.docusign.com/s/?language=en_US) or your account manager to find out whether the Web Forms API is available for your production account plan.</ds-inlinemessage>\n\nMethods for working with web forms."
0 commit comments