# HG changeset patch
# User Kim Alvefur <zash@zash.se>
# Date 1724091472 -7200
# Node ID 0616a6687d0ce2bf7c54dc3ece9913afbe092f69
# Parent  e5b5a74feb918d34ec4494bcbe9617af644678e0
mod_rest: Improve OpenAPI documentation for XEP-0363 GET method

It was half-done

diff -r e5b5a74feb91 -r 0616a6687d0c mod_rest/res/openapi.yaml
--- a/mod_rest/res/openapi.yaml	Mon Aug 19 20:08:41 2024 +0200
+++ b/mod_rest/res/openapi.yaml	Mon Aug 19 20:17:52 2024 +0200
@@ -230,16 +230,55 @@
     get:
       tags:
         - query
-      summary: Lorem ipsum
+      summary: Request space for uploading a file to the server.
       security:
         - basic: []
         - token: []
         - oauth2: []
       parameters:
         - $ref: '#/components/parameters/to'
+        - name: filename
+          in: query
+          required: true
+          schema:
+            type: string
+        - name: size
+          in: query
+          required: true
+          schema:
+            type: integer
+        - name: content-type
+          in: query
+          schema:
+            type: string
       responses:
         "200":
-          $ref: '#/components/responses/success'
+          description: Successful slot request.
+          content:
+            application/json:
+              schema:
+                type: object
+                xml:
+                  name: iq
+                properties:
+                  kind:
+                    type: string
+                    enum:
+                      - iq
+                  type:
+                    type: string
+                    enum:
+                      - result
+                    xml:
+                      attribute: true
+                  to:
+                    $ref: '#/components/schemas/to'
+                  from:
+                    $ref: '#/components/schemas/from'
+                  id:
+                    $ref: '#/components/schemas/id'
+                  upload_slot:
+                    $ref: '#/components/schemas/upload_slot'
 components:
   schemas:
     stanza: