autogen(docs): generate and format documentation

ory · Jan 7, 2022 · c605690 · c605690
1 parent 0d79906
commit c605690
Show file tree

Hide file tree

Showing 7 changed files with 17 additions and 38 deletions.
diff --git a/docs/docs/.static/api.json b/docs/docs/.static/api.json
@@ -73,6 +73,12 @@
             "description": "Relation of the Subject Set",
             "name": "subject_set.relation",
             "in": "query"
+          },
+          {
+            "type": "integer",
+            "format": "int64",
+            "name": "max-depth",
+            "in": "query"
           }
         ],
         "responses": {
@@ -167,6 +173,12 @@
             "schema": {
               "$ref": "#/definitions/RelationQuery"
             }
+          },
+          {
+            "type": "integer",
+            "format": "int64",
+            "name": "max-depth",
+            "in": "query"
           }
         ],
         "responses": {
@@ -282,8 +294,7 @@
             "type": "integer",
             "format": "int64",
             "name": "max-depth",
-            "in": "query",
-            "required": true
+            "in": "query"
           }
         ],
         "responses": {
@@ -485,8 +496,7 @@
             "type": "string",
             "description": "Namespace of the Relation Tuple",
             "name": "namespace",
-            "in": "query",
-            "required": true
+            "in": "query"
           },
           {
             "type": "string",

diff --git a/internal/httpclient/models/expand_tree.go b/internal/httpclient/models/expand_tree.go
diff --git a/internal/httpclient/models/get_relation_tuples_response.go b/internal/httpclient/models/get_relation_tuples_response.go
diff --git a/internal/httpclient/models/internal_relation_tuple.go b/internal/httpclient/models/internal_relation_tuple.go
diff --git a/internal/httpclient/models/patch_delta.go b/internal/httpclient/models/patch_delta.go
diff --git a/internal/httpclient/models/relation_query.go b/internal/httpclient/models/relation_query.go
diff --git a/spec/api.json b/spec/api.json
@@ -1075,8 +1075,7 @@
           "enum": [
             "insert",
             "delete"
-          ],
-          "x-go-enum-desc": "insert ActionInsert\ndelete ActionDelete"
+          ]
         },
         "relation_tuple": {
           "$ref": "#/definitions/InternalRelationTuple"
@@ -1151,15 +1150,13 @@
           "$ref": "#/definitions/SubjectSet"
         },
         "type": {
-          "description": "\nunion Union\nexclusion Exclusion\nintersection Intersection\nleaf Leaf",
           "type": "string",
           "enum": [
             "union",
             "exclusion",
             "intersection",
             "leaf"
-          ],
-          "x-go-enum-desc": "union Union\nexclusion Exclusion\nintersection Intersection\nleaf Leaf"
+          ]
         }
       }
     },