# 更新看板图表完整顺序

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

`PATCH /data-dashboards/{dashboard_id}/chart-order`，工作区由单个非空X-Workspace-ID确定。请求仅需chart_ids数组，但handler为普通单次JSON解码，不像下钻一样拒绝未知字段/第二个JSON值；不要混写严格程度。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```json
{"chart_ids":["chart-b","chart-a"]}
```

:::::
:::::{tab-item} 参数说明

| 字段 | 类型 | 约束 |
| --- | --- | --- |
| chart_ids | array（字符串数组） | 必须显式提供，非null；完整非deleted图表ID排列，非部分移动列表 |

service检查每个ID非空、无首尾空白；DAO在同租户事务内锁active看板和全部非deleted图表，要求数量一致、无重复、无外来ID。pending或deleting图表拒绝排序并映射409/ErrDataDashboardOperationActive。每张图表原layout_config字段保留，只将order设为从0开始的索引；未改变布局的不更新。不是重建图表或调整SQL。

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 字段说明

成功为code/msg/data封套，data.chart_ids回显顺序。空看板显式[]可经过校验，但service复制空切片后回显可能为null；不能据回显推导删除图表。省略/null输入映射400/ErrParamInvalid，非法排列同样400，缺对象404/ErrDataDashboardNotFound，权限/依赖沿看板错误映射。响应不提供并发版本，提交前重新读详情以免使用旧排列；

Go SDK及CLI当前把显式空数组省略成{}，Python保留[]，详见SDK差异；没有把三者记成整个排序能力缺失。

:::::
::::::
:::::::
