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

# 更新组件

> 更新嵌入式组件的名称、状态、关联密钥、外观、行为、安全或意图配置。

## 身份验证

需要 Bearer 令牌(API 密钥)或仪表盘会话。

## 路径参数

<ParamField path="id" type="string" required>
  该组件配置的 UUID。
</ParamField>

## 请求

所有字段均为可选 — 仅需包含你想要修改的字段。

<ParamField body="name" type="string">
  组件的显示名称。
</ParamField>

<ParamField body="status" type="string">
  `"active"` 或 `"disabled"`。
</ParamField>

<ParamField body="api_key_id" type="string">
  将该组件重新关联到另一个 API 密钥。
</ParamField>

<ParamField body="appearance" type="object">
  视觉自定义设置(`primaryColor`、`position`、`borderRadius`、`fontFamily` 等)。
</ParamField>

<ParamField body="behavior" type="object">
  行为设置(`welcomeMessage`、`placeholder`、`maxPromptLength`、`enableFileUpload`、`enableVoice`、`strictAbuse`)。
</ParamField>

<ParamField body="security" type="object">
  安全设置:机器人防护开关以及域名允许列表(`allowedOrigins`/`allowedDomains`)。
</ParamField>

<ParamField body="intent" type="object">
  人工升级意图配置(自定义关键词触发条件与操作)。
</ParamField>

## 响应

<ResponseField name="iframe" type="object">
  更新后的组件配置。
</ResponseField>

## 示例

```bash curl theme={null}
curl -X PATCH https://www.hitheo.ai/api/v1/iframes/CONFIG_ID \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "disabled" }'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.