> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

将指定成员从企业中删除。
## 所需权限 {#45b07a22}
`users:delete`
## 请求方式 {#def7e4e0}
```HTTP
DELETE /openapi/v1/users
```

## 请求参数 {#cbf5656a}
<!-- @cols-width: 183,183,150,307 -->
| | | | | \
|**参数** |**类型** |**是否必填** |**描述** |
|---|---|---|---|
| | | | | \
|`user_ids` |int[] |是 |待删除成员的 ID，最多 100 个。 |
| | | | | \
|`emails` |string[] |是 |待删除成员的邮箱，最多 100 个。 |

:::tip 提示
`user_ids` 和 `emails` 参数只需提供其中一个。
由于 `user_ids` 的优先级高于 `emails`，若同时传入两个参数，`emails` 会被忽略。
:::
## 响应参数 {#159eefad}
<!-- @cols-width: 244,244,337 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`success_count` |int |成功删除的成员数量。 |
| | | | \
|`failed_items` |array |删除失败的成员列表。 |

`failed_items[]` 数组包含以下参数：
<!-- @cols-width: 244,244,340 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`email` |string |删除失败的成员邮箱（即请求中传入的原始值）。 |
| | | | \
|`code` |int |错误码。 |
| | | | \
|`message` |string |失败原因。 |

## 请求示例 {#98f239a3}
```JSON
{
  "user_ids": [123, 456],
  "emails": ["a@test.com", "b@test.com"]
}
```

## 响应示例 {#4f6f7138}
```JSON
{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "success_count": 2,
    "failed_items": [
      {
        "email": "notexist@example.com",
        "code": 30007,
        "message": "user not found"
      }
    ]
  }
}
```