Issues in open API spec

[Mapiarz]

There's more things missing in the open api spec.

First, status field in the create submission response. Second, the get submission query param for combined pdf.

You could consider making the spec a part of this repo. Would've been easier to maintain I suppose?

@@ -1173,6 +1173,9 @@ paths:
                     slug:
                       type: string
                       description: Unique key to be used in the signing form URL.
+                    status:
+                      type: string
+                      description: The status of signing request for the submitter.
                     values:
                       type: array
                       description: An array of pre-filled values for the submission.
@@ -1288,6 +1291,13 @@ paths:
             type: integer
           description: The unique identifier of the submission.
           example: 1001
+        - name: include
+          in: query
+          schema:
+            type: string
+            description: What to include. Only possible value is combined_document_url.
+          required: false
+          description: Whether to include combined pdf url. cf. https://github.com/docusealco/docuseal/discussions/297
       responses:
         '200':
           description: OK

[Mapiarz]

Also missing property on get template response

@@ -397,6 +397,8 @@ paths:
                           description: >-
                             Unique identifier of the submitter that filled the
                             field.
+                        type:
+                          type: string
                         name:
                           type: string
                           description: Field name.

[Mapiarz]

And more. The values when talking about submitters can be either string or int, from my testing. Perhaps other types of fields come as different types as well, needs more investigation on your part guys.

@@ -1188,7 +1188,9 @@ paths:
                             type: string
                             description: Document template field name
                           value:
-                            type: string
+                            oneOf:
+                              - type: string
+                              - type: integer
                             description: Pre-filled value of the field.
                     metadata:
                       type: object
@@ -1410,7 +1412,9 @@ paths:
                                 type: string
                                 description: Document template field name
                               value:
-                                type: string
+                                oneOf:
+                                  - type: string
+                                  - type: integer
                                 description: Pre-filled value of the field.
                         documents:
                           type: array
@@ -1689,7 +1693,9 @@ paths:
                             type: string
                             description: Document template field name
                           value:
-                            type: string
+                            oneOf:
+                              - type: string
+                              - type: integer
                             description: Pre-filled value of the field.
                     metadata:
                       type: object
@@ -1933,7 +1939,9 @@ paths:
                           type: string
                           description: Document template field name
                         value:
-                          type: string
+                          oneOf:
+                            - type: string
+                            - type: integer
                           description: Pre-filled value of the field.
                   documents:
                     type: array
@@ -2176,7 +2184,9 @@ paths:
                           type: string
                           description: Document template field name
                         value:
-                          type: string
+                          oneOf:
+                            - type: string
+                            - type: integer
                           description: Pre-filled value of the field.
                   documents:
                     type: array
@@ -2397,7 +2407,9 @@ paths:
                                 type: string
                                 description: Document template field name
                               value:
-                                type: string
+                                oneOf:
+                                  - type: string
+                                  - type: integer
                                 description: Pre-filled value of the field.
                         documents:
                           type: array

[AlexBTurchyn]

@Mapiarz Thanks for reporting. I made some necessary changes except 'include' - we are not planning to make this parameter public. Let me know if everything works now as you expected