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

# Update a webhook endpoint

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

Updates a webhook endpoint with PATCH semantics — only the provided fields change. A `filterTypes` array replaces the current event types and must list at least one.

## Path parameters

- `id` string, required — Webhook endpoint ID

## Request body

- object
  - `url` string — HTTPS URL Atlas delivers events to
  - `description` string — Human-readable label for the endpoint
  - `disabled` boolean — Disabled endpoints receive no deliveries
  - `filterTypes` string[] — Event types to deliver to this endpoint. At least one is required

## Response `200`

Webhook endpoint updated

- object
  - `status` 'ok', required
  - `data` object, required
    - `id` string, required — Webhook endpoint ID
    - `url` string, required — Delivery URL
    - `description` string, required — Human-readable label
    - `disabled` boolean, required — Disabled endpoints receive no deliveries
    - `filterTypes` string[], nullable, required — Event types delivered to this endpoint
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `401` — Unauthorized - missing or invalid API key
- `404` — Resource not found
- `422` — Validation error - the request failed schema validation (`errors.fieldErrors`) or a business rule (`errors.formErrors`)
- `429` — Too many requests - the caller has exceeded the per-agency rate limit for the tier this endpoint counts against (default per minute: 1200 read / 400 write / 60 upload). Inspect the `RateLimit-*` headers — returned on every response, not only on 429s — and back off until the window resets. See the "Rate limits" section of the introduction for details.

## Changes

- **2026-10-03** `cd4bc8bbd95e` — 1 info
  - added the optional property `error` to the response with the `422` status
- **2026-09-29** `d7ef7f970d5b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/recruitwithatlas/apis/atlas-api/changes/api/v1/webhooks/endpoints/:id/patch.md)

---

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