@dotcms/ai 26.9.2-1 → 26.9.3-1-next.2632

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/ai",
-  "version": "26.09.02-01",
+  "version": "26.9.3-1-next.2632",
   "description": "The dotCMS agentic runtime — run model-written or human-written code safely against a dotCMS instance, with auth and policy owned in one place.",
   "repository": {
     "type": "git",

package/spec.cjs.js

@@ -7881,7 +7881,7 @@ var paths = {
 	},
 	"/api/v1/users/filter": {
 		get: {
-			description: "Returns a list of dotCMS users based on specified search criteria with pagination support",
+			description: "Returns a list of dotCMS users based on specified search criteria with pagination support. Each item is the user's data map. When `includeRoles=true` is passed, each item additionally carries a `roles` array listing the user's directly assigned roles as `{id, name, roleKey}` objects (`roleKey` may be null for roles created without a key); roles held through the role hierarchy and the user's personal role are not included. Requesting roles requires being a CMS Administrator or having access to both the Roles and Users portlets (403 otherwise). Without the flag the payload is unchanged.",
 			operationId: "filterUsers",
 			parameters: [
 				{
@@ -7972,6 +7972,15 @@ var paths = {
 							type: "string"
 						}
 					}
+				},
+				{
+					description: "When true, each user carries a `roles` array of its directly assigned roles as {id, name, roleKey}; inherited roles and the user's personal role are excluded. Requires CMS Administrator or Roles+Users portlet access (403 otherwise). Defaults to false (payload unchanged)",
+					"in": "query",
+					name: "includeRoles",
+					schema: {
+						type: "boolean",
+						"default": false
+					}
 				}
 			],
 			responses: {
@@ -8004,7 +8013,7 @@ var paths = {
 						"application/json": {
 						}
 					},
-					description: "Forbidden - insufficient permissions"
+					description: "Forbidden - insufficient permissions, or includeRoles=true requested without CMS Administrator / Roles+Users portlet access"
 				}
 			},
 			summary: "Filter users",

package/spec.esm.js

@@ -7879,7 +7879,7 @@ var paths = {
 	},
 	"/api/v1/users/filter": {
 		get: {
-			description: "Returns a list of dotCMS users based on specified search criteria with pagination support",
+			description: "Returns a list of dotCMS users based on specified search criteria with pagination support. Each item is the user's data map. When `includeRoles=true` is passed, each item additionally carries a `roles` array listing the user's directly assigned roles as `{id, name, roleKey}` objects (`roleKey` may be null for roles created without a key); roles held through the role hierarchy and the user's personal role are not included. Requesting roles requires being a CMS Administrator or having access to both the Roles and Users portlets (403 otherwise). Without the flag the payload is unchanged.",
 			operationId: "filterUsers",
 			parameters: [
 				{
@@ -7970,6 +7970,15 @@ var paths = {
 							type: "string"
 						}
 					}
+				},
+				{
+					description: "When true, each user carries a `roles` array of its directly assigned roles as {id, name, roleKey}; inherited roles and the user's personal role are excluded. Requires CMS Administrator or Roles+Users portlet access (403 otherwise). Defaults to false (payload unchanged)",
+					"in": "query",
+					name: "includeRoles",
+					schema: {
+						type: "boolean",
+						"default": false
+					}
 				}
 			],
 			responses: {
@@ -8002,7 +8011,7 @@ var paths = {
 						"application/json": {
 						}
 					},
-					description: "Forbidden - insufficient permissions"
+					description: "Forbidden - insufficient permissions, or includeRoles=true requested without CMS Administrator / Roles+Users portlet access"
 				}
 			},
 			summary: "Filter users",