# 更新用户状态

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

启用或禁用指定用户的工作区成员关系。禁用后，该用户不能继续访问当前工作区。

```text
POST https://api.moi.matrixorigin.cn/v5/user/update_status
```

## 调用前准备

先[选择用户](list-users.md#选择用户)，确认要启用或禁用的成员关系。

准备具有目标工作区相应权限的[个人访问令牌](../../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)和[目标工作区 ID](../../../../../guides/ai-studio/resource-center/workspace.md#复制工作区-id)。

## 请求参数

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

```bash
curl -X POST "https://api.moi.matrixorigin.cn/v5/user/update_status" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "user-001"
  }'
```

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

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| id | string | 是 | 用户 ID。 |
| action | string | 是 | 状态动作，只能为 enable 或 disable。 |

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

## 成功响应

成功时用户已启用或禁用，响应中的 data 为 null。

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "OK",
  "msg": "OK",
  "data": null
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| code | string | 成功时为 OK。 |
| msg | string | 成功时为 OK。 |
| data | null | 成功时固定为 null。 |

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

## 错误响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "INVALID_ARGUMENT",
  "msg": "请求参数无效",
  "data": null
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| code | string | 错误代码。 |
| msg | string | 错误信息。 |
| data | null | — |

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