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

# Update Hook

> Enable or disable a hook, or change its cooldown and configuration.

## Path Parameters

<ParamField path="id" type="string" required>
  The hook UUID.
</ParamField>

## Request

All fields are optional — include only what you want to change.

<ParamField body="enabled" type="boolean">
  Enable or disable the hook. Disabled hooks never fire.
</ParamField>

<ParamField body="cooldown_minutes" type="number">
  Minimum time between firings in minutes (1–1440).
</ParamField>

<ParamField body="config" type="object">
  Hook-specific configuration overrides.
</ParamField>

## Response

```json theme={null}
{ "updated": true }
```

## Authentication

Requires an API key with `completions` scope.

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X PATCH https://www.hitheo.ai/api/v1/hooks/HOOK_ID \
    -H "Authorization: Bearer $THEO_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "enabled": false }'
  ```

  ```typescript SDK theme={null}
  await theo.updateHook("HOOK_ID", { enabled: false });
  ```
</CodeGroup>