[POST] .../v1/userrole/get
Returns information about roles user. Use this method to list direct roles assigned to a user before editing RBAC membership or calculating visible permissions. The response returns UserRole rows with assignment id, user_id and the role object; the request body is required and supports filters for user_id. The caller must have user-role get permission 17 and user_id must be positive. Missing body, invalid user_id, denied permission, invalid filters and persistent lookup failures are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| filters | Array of Filter | Optional | Optional filters by fields available for this API method. |
Filterable Fields
| Field | Type | Description |
|---|---|---|
| user_id | int | System user ID. |
Request Example
{
"filters": [
{
"Field": "user_id",
"Operator": "Equal",
"Value": "17"
}
]
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Array of UserRole | Result array. |
Response Example
{
"ok": true,
"result": [
{
"id": 51,
"user_id": 17,
"role": {
"id": 4,
"name": "Cashier",
"description": "POS operator role",
"last_update": 1712345600
}
}
]
}