---
title: "Clear agent hooks"
method: DELETE
path: "/v1/agents/{id}/hooks"
---

# Clear agent hooks

`DELETE /v1/agents/{id}/hooks`

## Request

- Base URL: `https://api.runbear.io`
- URL: `https://api.runbear.io/v1/agents/{id}/hooks`
- Auth: HTTP bearer

Remove the agent's hooks document and the vault secrets its headers referenced. The Custom MCP integrations hooks pointed at are left intact. Idempotent — succeeds whether or not hooks were set. Returns 404 only when the agent is not found or its provider does not run hooks.

## Path parameters

- `id` string, uuid, required: Agent ID

## Response `204`

Hooks cleared

## Other responses

- `404`: Default Response

---

[API](https://skmtc.dev/runbear/apis/runbear-api.md) - [All operations](https://skmtc.dev/runbear/apis/runbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runbear/apis/runbear-api/revisions/c6a9c3066a5a?raw)