Add permission description for API to add repo collaborator (#31744)

Fix #31552.

diff --git a/modules/structs/repo_collaborator.go b/modules/structs/repo_collaborator.go
index 946a6ec7e78e010b199f939c286b287c16fa9f45..7d39b5a798a26bfd4ac878699c971163ad8a25ef 100644 (file)
--- a/modules/structs/repo_collaborator.go
+++ b/modules/structs/repo_collaborator.go
@@ -5,6 +5,7 @@ package structs
 
 // AddCollaboratorOption options when adding a user as a collaborator of a repository
 type AddCollaboratorOption struct {
+       // enum: read,write,admin
        Permission *string `json:"permission"`
 }
 

diff --git a/templates/swagger/v1_json.tmpl b/templates/swagger/v1_json.tmpl
index 18b9cdab3a3f2c9c0de80e521b892abf5606e195..bfaa86428c9528c81febd7635de4b330271ef610 100644 (file)
--- a/templates/swagger/v1_json.tmpl
+++ b/templates/swagger/v1_json.tmpl
@@ -18484,6 +18484,11 @@
       "properties": {
         "permission": {
           "type": "string",
+          "enum": [
+            "read",
+            "write",
+            "admin"
+          ],
           "x-go-name": "Permission"
         }
       },