Skip to main content
PATCH
/
api
/
v1
/
hooks
/
{id}
Update Hook
curl --request PATCH \
  --url https://api.example.com/api/v1/hooks/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "enabled": true,
  "cooldown_minutes": 123,
  "config": {}
}
'

​
Path Parameters

​
id
string
required
The hook UUID.

​
Request

All fields are optional — include only what you want to change.
​
enabled
boolean
Enable or disable the hook. Disabled hooks never fire.
​
cooldown_minutes
number
Minimum time between firings in minutes (1–1440).
​
config
object
Hook-specific configuration overrides.

​
Response

{ "updated": true }

​
Authentication

Requires an API key with completions scope.

​
Example

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 }'