> ## 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.

# 发布事件

> 发布自定义事件以触发工作流和集成。

将自定义事件发布到 Theo 事件总线。事件可以触发工作流、连接器操作和技能激活。

## 身份验证

需要 Bearer 令牌。参见[身份验证](/api-reference/authentication)。

## 请求正文

<ParamField body="orgId" type="string" required>
  该事件所属组织的 UUID。
</ParamField>

<ParamField body="eventType" type="string" required>
  事件类型标识符（例如 `"claim.created"`、`"policy.renewed"`）。
</ParamField>

<ParamField body="payload" type="any">
  任意事件负载数据。
</ParamField>

<ParamField body="sourceConnector" type="string">
  产生该事件的连接器 ID。
</ParamField>

## 请求示例

```bash theme={null}
curl -X POST https://www.hitheo.ai/api/v1/events \
  -H "Authorization: Bearer $THEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "org_abc123",
    "eventType": "claim.created",
    "payload": { "claimId": "CLM-001", "amount": 15000, "type": "auto" }
  }'
```

## 响应

返回已发布的事件对象，包含生成的 `id` 和时间戳。

## 端点

`POST /api/v1/events`

需要通过 Bearer 令牌进行身份验证。参见[身份验证](/api-reference/authentication)。


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