---
title: "Изменить вебхук"
method: PATCH
path: "/v3/webhooks/{webhook_id}"
tags: ["webhooks"]
---

# Изменить вебхук

`PATCH /v3/webhooks/{webhook_id}`

## Request

- Base URL: `https://api.rewio.ru`
- URL: `https://api.rewio.ru/v3/webhooks/{webhook_id}`
- Auth: API key in header `X-API-Key`

Изменить подписку: адрес, состав объектов, события, окно, фильтры,
включённость. Передавайте только то, что меняется.

## Path parameters

- `webhook_id` integer, required

## Request body

- WebhookUpdateV3: Изменение подписки — передавайте только изменяемые поля.
  - `target` string, nullable: Новый адрес доставки.
  - `object_ids` integer[], nullable: Новый список объектов.
  - `event_types` string[], nullable: Новый набор событий.
  - `bucket_window` string, nullable: Delivery cadence. `immediate` — one POST shortly after each scrape batch; `daily_<hour>` — one digest per day at the given UTC hour (0–23), e.g. `daily_9` = 09:00 UTC, `daily_14` = 14:00 UTC.
  - `filters` FiltersV2: Фильтры доставки (/v2). AND-комбинируются. Канонические имена ``has_text`` / ``has_images`` вместо внутренних ``require_text`` / ``require_images``.
    - `allowed_ratings` integer[]
    - `allowed_sources` string[], nullable
    - `has_text` boolean
    - `has_images` boolean
  - `is_active` boolean, nullable: Включить или выключить подписку.

## Response `200`

Successful Response

- WebhookV3: Подписка на события.
  - `id` integer, required: Идентификатор подписки.
  - `target` string, required: Адрес доставки.
  - `object_ids` integer[], nullable: Объекты, по которым приходят события. `null` — по всем.
  - `event_types` string[], required: События подписки.
  - `bucket_window` string, required: Окно группировки событий в одну доставку.
  - `filters` FiltersV2, required: Фильтры доставки (/v2). AND-комбинируются. Канонические имена ``has_text`` / ``has_images`` вместо внутренних ``require_text`` / ``require_images``.
    - `allowed_ratings` integer[]
    - `allowed_sources` string[], nullable
    - `has_text` boolean
    - `has_images` boolean
  - `is_active` boolean, required: Включена ли подписка.
  - `failure_count` integer, required: Сколько неудачных доставок подряд.
  - `last_failure_at` string, date-time, nullable: Момент последней неудачи (UTC, ISO 8601).
  - `created_at` string, date-time, required: Момент создания подписки (UTC, ISO 8601).
  - `updated_at` string, date-time, required: Момент последнего изменения (UTC, ISO 8601).

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/rewio/apis/review-aggregator.md) · [All operations](https://skmtc.dev/rewio/apis/review-aggregator/llms.txt) · [OpenAPI document](https://skmtc.dev/rewio/apis/review-aggregator/revisions/9222b6cf28a5?raw)