---
title: "Обновить ссылку"
method: PUT
path: "/v3/objects/{object_id}/links/{link_id}"
tags: ["links"]
---

# Обновить ссылку

`PUT /v3/objects/{object_id}/links/{link_id}`

## Request

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

Обновить ссылку объекта: своё название (`link_name`) и/или участие в
сборе (`is_active`).

## Path parameters

- `object_id` integer, required: Идентификатор объекта
- `link_id` integer, required: Encoded link ID

## Request body

- LinkUpdateV3: Изменение ссылки внутри объекта. Передавайте только изменяемые поля.
  - `link_name` string, nullable: Новое своё название ссылки внутри объекта. Не передано — не меняется.
  - `is_active` boolean, nullable: Собирать ли отзывы по этой ссылке. Не передано — не меняется.

## Response `200`

Successful Response

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

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