Merge pull request #8030 from camunda/45404-update-authorization-api-docs-missing-400-response

Adding 400 response for authorization update

Author: ana-vinogradova-camunda

docs/apis-tools/orchestration-cluster-api-rest/specifications/update-authorization.api.mdx

@@ -49,7 +49,7 @@ Update the authorization with the given key.
       name: "authorizationKey",
       in: "path",
       required: true,
-      description: "The key of the authorization to delete.",
+      description: "The key of the authorization to update.",
       schema: {
         allOf: [
           {
@@ -338,6 +338,55 @@ Update the authorization with the given key.
   label={undefined}
   responses={{
     "204": { description: "The authorization was updated successfully." },
+    "400": {
+      description: "The authorization update request is invalid.",
+      headers: { "WWW-Authenticate": { schema: { type: "string" } } },
+      content: {
+        "application/problem+json": {
+          schema: {
+            description:
+              "A Problem detail object as described in [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457). There may be additional properties specific to the problem type.\n",
+            type: "object",
+            properties: {
+              type: {
+                type: "string",
+                format: "uri",
+                description: "A URI identifying the problem type.",
+                default: "about:blank",
+                example: "about:blank",
+              },
+              title: {
+                type: "string",
+                description: "A summary of the problem type.",
+                example: "Bad Request",
+              },
+              status: {
+                type: "integer",
+                format: "int32",
+                description: "The HTTP status code for this problem.",
+                example: 400,
+                minimum: 400,
+                maximum: 600,
+              },
+              detail: {
+                type: "string",
+                description: "An explanation of the problem in more detail.",
+                example:
+                  "At least one of [resourceId, resourcePropertyName] is required",
+              },
+              instance: {
+                type: "string",
+                format: "uri",
+                description:
+                  "A URI path identifying the origin of the problem.",
+                example: "/v2/authorizations/2251799813685318",
+              },
+            },
+            title: "ProblemDetail",
+          },
+        },
+      },
+    },
     "401": {
       description: "The request lacks valid authentication credentials.",
       headers: { "WWW-Authenticate": { schema: { type: "string" } } },

versioned_docs/version-8.8/apis-tools/orchestration-cluster-api-rest/specifications/update-authorization.api.mdx

@@ -188,6 +188,55 @@ Update the authorization with the given key.
   label={undefined}
   responses={{
     "204": { description: "The authorization was updated successfully." },
+    "400": {
+      description: "The authorization update request is invalid.",
+      headers: { "WWW-Authenticate": { schema: { type: "string" } } },
+      content: {
+        "application/problem+json": {
+          schema: {
+            description:
+              "A Problem detail object as described in [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457). There may be additional properties specific to the problem type.\n",
+            type: "object",
+            properties: {
+              type: {
+                type: "string",
+                format: "uri",
+                description: "A URI identifying the problem type.",
+                default: "about:blank",
+                example: "about:blank",
+              },
+              title: {
+                type: "string",
+                description: "A summary of the problem type.",
+                example: "Bad Request",
+              },
+              status: {
+                type: "integer",
+                format: "int32",
+                description: "The HTTP status code for this problem.",
+                example: 400,
+                minimum: 400,
+                maximum: 600,
+              },
+              detail: {
+                type: "string",
+                description: "An explanation of the problem in more detail.",
+                example:
+                  "At least one of [resourceId, resourcePropertyName] is required",
+              },
+              instance: {
+                type: "string",
+                format: "uri",
+                description:
+                  "A URI path identifying the origin of the problem.",
+                example: "/v2/authorizations/2251799813685318",
+              },
+            },
+            title: "ProblemDetail",
+          },
+        },
+      },
+    },
     "401": {
       description: "The request lacks valid authentication credentials.",
       headers: { "WWW-Authenticate": { schema: { type: "string" } } },