docs(api): document 401/403 responses for user key endpoints (#38711)

This commit is contained in:
Mitrahsoft
2026-08-14 08:25:44 +05:30
committed by GitHub
parent 72a9debaff
commit befeacdf7d
5 changed files with 176 additions and 0 deletions
+69
View File
@@ -1711,6 +1711,21 @@
},
"description": "APIString is a string response"
},
"unauthorized": {
"description": "APIUnauthorizedError is an unauthorized error response",
"headers": {
"message": {
"schema": {
"type": "string"
}
},
"url": {
"schema": {
"type": "string"
}
}
}
},
"validationError": {
"description": "APIValidationError is error format response related to input validation",
"headers": {
@@ -34970,6 +34985,12 @@
"200": {
"$ref": "#/components/responses/string"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
"404": {
"$ref": "#/components/responses/notFound"
}
@@ -34987,6 +35008,12 @@
"201": {
"$ref": "#/components/responses/GPGKey"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
"404": {
"$ref": "#/components/responses/notFound"
},
@@ -35024,6 +35051,12 @@
"responses": {
"200": {
"$ref": "#/components/responses/GPGKeyList"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
}
},
"summary": "List the authenticated user's GPG keys",
@@ -35047,6 +35080,12 @@
"201": {
"$ref": "#/components/responses/GPGKey"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
"404": {
"$ref": "#/components/responses/notFound"
},
@@ -35079,6 +35118,9 @@
"204": {
"$ref": "#/components/responses/empty"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
@@ -35109,6 +35151,12 @@
"200": {
"$ref": "#/components/responses/GPGKey"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
"404": {
"$ref": "#/components/responses/notFound"
}
@@ -35290,6 +35338,12 @@
"responses": {
"200": {
"$ref": "#/components/responses/PublicKeyList"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
}
},
"summary": "List the authenticated user's public keys",
@@ -35313,6 +35367,12 @@
"201": {
"$ref": "#/components/responses/PublicKey"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
"422": {
"$ref": "#/components/responses/validationError"
}
@@ -35342,6 +35402,9 @@
"204": {
"$ref": "#/components/responses/empty"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
@@ -35372,6 +35435,12 @@
"200": {
"$ref": "#/components/responses/PublicKey"
},
"401": {
"$ref": "#/components/responses/unauthorized"
},
"403": {
"$ref": "#/components/responses/forbidden"
},
"404": {
"$ref": "#/components/responses/notFound"
}