---
title: "Включить/выключить объекты"
method: PUT
path: "/v3/objects"
tags: ["objects"]
---

# Включить/выключить объекты

`PUT /v3/objects`

## Request

- Base URL: `https://api.rewio.ru`
- URL: `https://api.rewio.ru/v3/objects`
- Auth: API key in header `X-API-Key`

Массово включить или выключить объекты — то же поле `is_active`, что и в
`PUT /v3/objects/{object_id}`, применённое к набору за один вызов.

**Переключается всё, что можно переключить.** `object_id`, недоступный
вызывающему (чужой, несуществующий, удалённый), молча пропускается —
остальные переключаются как обычно. Не нашлось ни одного — ответ с пустым
`data`. Лимит объектов переключение не трогает: место в тарифе занимает
существование объекта, а не его включённость.

## Request body

- ObjectsSwitchV3: Массовое включение/выключение объектов одним вызовом.
  - `object_ids` integer[], required: Идентификаторы объектов. Недоступные вам молча пропускаются — в ответе придут только те, что удалось тронуть.
  - `is_active` boolean, required: Одно значение на вызов: включить или выключить.

## Response `200`

Successful Response

- ReturnAllObjectV3
  - `data` ObjectV3[], required: Все элементы (пагинации нет).
    - `id` integer, required: Идентификатор объекта.
    - `name` string, required: Название объекта.
    - `is_active` boolean, required: Включён ли объект. Выключенный не отдаёт отзывы и аналитику и не собирается, но остаётся у вас и продолжает занимать место в тарифе.
    - `scrape_status` 'pending' | 'in_progress' | 'success' | 'partial' | 'failed', required: Сводный статус сбора по объекту. Значения те же, что в предыдущей версии.
    - `last_scraped_at` string, date-time, nullable: Последний сбор по объекту (UTC, ISO 8601).
    - `created_at` string, date-time, required: Момент создания объекта (UTC, ISO 8601).
    - `links` LinkV3[]: Ссылки объекта на разных площадках.
      - `id` integer, required: Идентификатор ссылки.
      - `url` string, required: URL страницы объекта на площадке.
      - `source_id` integer, required: Идентификатор площадки ссылки (см. `GET /v3/sources`).
      - `link_name` string, nullable: Своё название ссылки внутри объекта, если задано.
      - `auto_name` string, nullable: Название, определённое нами по ссылке, с подписью площадки через двоеточие. Показывать стоит `link_name`, если задано, иначе `auto_name`.
      - `is_active` boolean, required: Включена ли ссылка в автосбор отзывов.
      - `scrape_status` 'pending' | 'in_progress' | 'success' | 'failed', required: Статус последнего сбора отзывов по ссылке. Значения совпадают с DB-enum `Link.scrape_status` (`app/models/link.py`).
      - `scrape_error` string, nullable: Текст ошибки последнего неудачного сбора. `null`, когда сбор успешен.
      - `last_scraped_at` string, date-time, nullable: Момент последнего сбора по ссылке (UTC, ISO 8601).
      - `last_scraped_review_date` string, date-time, nullable: Дата публикации самого свежего собранного отзыва по ссылке.
      - `created_at` string, date-time, required: Момент добавления ссылки в объект (UTC, ISO 8601).
    - `is_demo` boolean: Пример, который мы положили в кабинет при регистрации. Занимает место в тарифе, исчезает после первой оплаты; удалить можно как обычный объект.
    - `review_count` integer, nullable: Сколько отзывов объекта доступно вам сейчас: по включённым ссылкам, без удалённых на площадке, в пробном периоде — в пределах его окна. Скрытые и закреплённые через API здесь не вычитаются, поэтому `total` у `GET /v3/reviews?object_id=…` может быть меньше на их число. Есть в списке объектов и в `GET /v3/objects/{object_id}`; в ответах на изменение — `null`.

## 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)