[POST] .../v1/dashboard/edit
Edits a dashboard. Use this method to rename a dashboard or change its fixed flag without changing dashboard-level firm, stock or period filters. The method loads the active dashboard, checks creator ownership or the dashboard all-edit permission, blocks protected fixed/system behavior through persistent validation, applies provided editable fields, writes an action log record, clears dashboard cache and returns row_affected. The request body is required, id must be positive, name is optional but limited to 50 characters when provided and omitted fields are left unchanged. Business errors such as missing body, invalid id, long name, missing dashboard, denied access, fixed dashboard restrictions, no editable fields, database errors, transaction failures and action-log failures are returned as HTTP 200 ErrorResult.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | Int64 | Required | Dashboard ID. |
| is_fixed | Boolean | Optional | Fixed dashboard flag. Omit or pass null to leave the flag unchanged. |
| name | String | Optional | New dashboard name, up to 50 characters. Omit or pass null to leave the name unchanged. |
Request Example
{
"id": 3,
"name": "Sales overview Q2",
"is_fixed": false
}
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
}
}