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

# 獲取 Webhook 列表

> 列出為調用方所屬組織註冊的所有 Webhook 端點。

## 響應

<ResponseField name="webhooks" type="array">
  Webhook 對象組成的數組。

  <Expandable title="Webhook 對象">
    <ResponseField name="id" type="string">UUID</ResponseField>
    <ResponseField name="url" type="string">端點 URL</ResponseField>
    <ResponseField name="event_types" type="string[]">已訂閱的事件類型</ResponseField>
    <ResponseField name="enabled" type="boolean">該 Webhook 是否處於啓用狀態</ResponseField>
    <ResponseField name="last_delivered_at" type="string | null">最近一次成功投遞的 ISO 8601 時間戳</ResponseField>
    <ResponseField name="failure_count" type="number">連續失敗次數（成功後重置）</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 時間戳</ResponseField>
  </Expandable>
</ResponseField>

## 示例

<CodeGroup>
  ```bash curl theme={null}
  curl https://www.hitheo.ai/api/v1/webhooks \
    -H "Authorization: Bearer $THEO_API_KEY"
  ```

  ```typescript SDK theme={null}
  const webhooks = await theo.listWebhooks();
  ```
</CodeGroup>

### 響應

```json theme={null}
{
  "webhooks": [
    {
      "id": "a1b2c3d4-...",
      "url": "https://your-server.com/webhooks/theo",
      "event_types": ["completion.created", "job.completed"],
      "enabled": true,
      "last_delivered_at": "2026-04-15T11:30:00.000Z",
      "failure_count": 0,
      "created_at": "2026-04-10T08:00:00.000Z"
    }
  ]
}
```

<Note>
  創建之後將不再返回 `signing_secret`。如果遺失了該密鑰，請使用[輪換密鑰](/api-reference/webhooks/rotate-secret)端點生成新的密鑰。
</Note>


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