diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json
index 4d772246d3..3b16e96067 100644
--- a/output/openapi/elasticsearch-serverless-openapi.json
+++ b/output/openapi/elasticsearch-serverless-openapi.json
@@ -61559,7 +61559,7 @@
       "security.put_role#name": {
         "in": "path",
         "name": "name",
-        "description": "The name of the role.",
+        "description": "The name of the role that is being created or updated. On Elasticsearch Serverless, the role name must begin with a letter or digit and can only contain letters, digits and the characters '_', '-', and '.'. Each role must have a unique name, as this will serve as the identifier for that role.",
         "required": true,
         "deprecated": false,
         "schema": {
diff --git a/output/schema/schema-serverless.json b/output/schema/schema-serverless.json
index cd8b7feee5..ba94ed4dbd 100644
--- a/output/schema/schema-serverless.json
+++ b/output/schema/schema-serverless.json
@@ -39974,7 +39974,7 @@
       },
       "path": [
         {
-          "description": "The name of the role.",
+          "description": "The name of the role that is being created or updated. On Elasticsearch Serverless, the role name must begin with a letter or digit and can only contain letters, digits and the characters '_', '-', and '.'. Each role must have a unique name, as this will serve as the identifier for that role.",
           "name": "name",
           "required": true,
           "type": {
diff --git a/specification/security/put_role/SecurityPutRoleRequest.ts b/specification/security/put_role/SecurityPutRoleRequest.ts
index fa12cf430e..09f818145b 100644
--- a/specification/security/put_role/SecurityPutRoleRequest.ts
+++ b/specification/security/put_role/SecurityPutRoleRequest.ts
@@ -39,7 +39,7 @@ import { Metadata, Name, Refresh } from '@_types/common'
 export interface Request extends RequestBase {
   path_parts: {
     /**
-     * The name of the role.
+     * The name of the role that is being created or updated. On Elasticsearch Serverless, the role name must begin with a letter or digit and can only contain letters, digits and the characters '_', '-', and '.'. Each role must have a unique name, as this will serve as the identifier for that role.
      */
     name: Name
   }