---
title: "Update a webhook"
method: PATCH
path: "/api/v1/webhooks/{id}"
tags: ["Agents API: webhooks"]
---

# Update a webhook

`PATCH /api/v1/webhooks/{id}`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/v1/webhooks/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `Authorization`

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `url` string, uri: HTTPS endpoint that receives events.
  - `events` string[]: Event types from GET /api/v1/webhooks/events. Empty means all.
  - `agentId` string, uuid: Limit the endpoint to one agent. Account events are then unavailable.
  - `description` string: Free text shown in the dashboard.
  - `active` boolean

## Response `200`

The { data, meta: { requestId, timestamp } } envelope.

## Other responses

- `400`: invalid_parameter, bad_json or a route-specific validation code.
- `401`: unauthorized
- `403`: insufficient_scope
- `404`: not_found
- `429`: rate_limited, with Retry-After.

---

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