[POST] .../v1/userdashboard/remove
Removes a dashboard assignment from a user. Use this destructive method to remove a dashboard from a user's assigned dashboard list. The method checks the user-dashboard remove permission, resolves user_id from the request or current request context when user_id is omitted or 0, validates the user and assignment, rejects the default dashboard assignment and deletes the user-dashboard link; when the selected user is the dashboard creator, the linked dashboard is also soft-deleted and affected users are moved back to the system default dashboard. The request body is required and dashboard_id must be positive, while user_id may be 0 to target the current request user. Business errors such as missing body, invalid dashboard_id, denied permission, missing current user context, missing user or assignment, default-dashboard deletion, database errors, transaction failures, no affected rows and action-log failures are returned as HTTP 200 ErrorResult.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| dashboard_id | Int64 | Required | Dashboard ID. |
| user_id | Int64 | Optional | User ID. If omitted or 0, the current request user is used. |
Request Example
{
"user_id": 0,
"dashboard_id": 3
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Update | Update operation result. |
Response Example
{
"ok": true,
"result": {
"row_affected": 1,
"ids": []
}
}