Skip to main content
GET
/
api
/
v1
/
hooks
List Hooks
curl --request GET \
  --url https://api.example.com/api/v1/hooks
{
  "hooks": [
    {}
  ],
  "presets": [
    {}
  ]
}

​
Response

​
hooks
array
Array of installed hooks. Each includes id, event_pattern, skill_slug, enabled, cooldown_minutes, consecutive_failures, last_fired_at, created_at.
​
presets
array
Array of available hook presets. Each includes id, event_pattern, default_skill, description.

​
Authentication

Requires an API key with completions scope.

​
Example

curl
curl https://www.hitheo.ai/api/v1/hooks \
  -H "Authorization: Bearer $THEO_API_KEY"

​
Response

{
  "hooks": [
    {
      "id": "a1b2c3d4-...",
      "event_pattern": "order.*.completed",
      "skill_slug": "order-processor",
      "enabled": true,
      "cooldown_minutes": 5,
      "consecutive_failures": 0,
      "last_fired_at": null,
      "created_at": "2026-04-15T12:00:00.000Z"
    }
  ],
  "presets": [
    {
      "id": "share.accepted.welcome",
      "event_pattern": "share.accepted",
      "default_skill": "email-drafter",
      "description": "Welcome on share accept"
    }
  ]
}

​
Management

  • PATCH /api/v1/hooks/{id} — Update config, enable/disable
  • DELETE /api/v1/hooks/{id} — Remove
  • GET /api/v1/hooks/{id} — View execution history