# Users URL: /bengal/api/bengal-demo-commerce/tags/users/ Section: users --- > For a complete page index, fetch /bengal/llms.txt. Resource group # Users 5 endpoints ## Endpoints Method Endpoint Description GET `/users` (/bengal/api/bengal-demo-commerce/tags/users/get-users/) List users POST `/users` (/bengal/api/bengal-demo-commerce/tags/users/post-users/) Create user GET `/users/{userId}` (/bengal/api/bengal-demo-commerce/tags/users/get-users-{userId}/) Get user PATCH `/users/{userId}` (/bengal/api/bengal-demo-commerce/tags/users/patch-users-{userId}/) Update user profile POST `/users/{userId}/sessions` (/bengal/api/bengal-demo-commerce/tags/users/post-users-{userId}-sessions/) Create session token GET `/users` ## List users Returns a paginated list of users with optional role filtering. ### Parameters #### Query `page` integer query Page number (1-based) Default: `1` `page_size` integer query Number of results per page Default: `25` `role` string query Filter by role Allowed: `admin``support``member` ## Responses `200` Paginated users Content-Type: `application/json` `items` array Items: `items items` object `page` integer `total` integer `401` Authentication required Content-Type: `application/json` POST `/users` ## Create user ## Request Body requiredapplication/json `items` array Items: `items items` object `page` integer `total` integer ## Responses `201` User created Content-Type: `application/json` `items` array Items: `items items` object `page` integer `total` integer `400` Validation failed Content-Type: `application/json` `items` array Items: `items items` object `page` integer `total` integer GET `/users/{userId}` ## Get user ### Parameters #### Path `userId` string requiredpath ## Responses `200` User details Content-Type: `application/json` `items` array Items: `items items` object `page` integer `total` integer `404` Resource not found Content-Type: `application/json` PATCH `/users/{userId}` ## Update user profile ### Parameters #### Path `userId` string requiredpath ## Request Body requiredapplication/json `items` array Items: `items items` object `page` integer `total` integer ## Responses `200` Updated user Content-Type: `application/json` `items` array Items: `items items` object `page` integer `total` integer `400` Validation failed Content-Type: `application/json` `items` array Items: `items items` object `page` integer `total` integer `404` Resource not found Content-Type: `application/json` POST `/users/{userId}/sessions` ## Create session token Issue a short-lived session token using password credentials or MFA code. ### Parameters #### Path `userId` string requiredpath ## Request Body requiredapplication/json `items` array Items: `items items` object `page` integer `total` integer ## Responses `201` Session token issued Content-Type: `application/json` `items` array Items: `items items` object `page` integer `total` integer `401` Authentication required Content-Type: `application/json`