---
title: "POST /v4/partners/{partnerId}/channels/{+channelId}/sites:replace"
method: POST
path: "/v4/partners/{partnerId}/channels/{+channelId}/sites:replace"
tags: ["partners"]
---

# POST /v4/partners/{partnerId}/channels/{+channelId}/sites:replace

`POST /v4/partners/{partnerId}/channels/{+channelId}/sites:replace`

## Request

- Base URL: `https://displayvideo.googleapis.com`
- URL: `https://displayvideo.googleapis.com/v4/partners/{partnerId}/channels/{+channelId}/sites:replace`
- Auth: OAuth 2 (implicit, authorization URL `https://accounts.google.com/o/oauth2/auth`, scopes: `https://www.googleapis.com/auth/display-video`) and OAuth 2 (authorization code, authorization URL `https://accounts.google.com/o/oauth2/auth`, token URL `https://accounts.google.com/o/oauth2/token`, scopes: `https://www.googleapis.com/auth/display-video`)

Replaces all of the sites under a single channel. The operation will replace the sites under a channel with the sites provided in ReplaceSitesRequest.new_sites. **This method regularly experiences high latency.** We recommend [increasing your default timeout](/display-video/api/guides/best-practices/timeouts#client_library_timeout) to avoid errors.

## Path parameters

- `partnerId` string, required
- `channelId` string, required

## Request body

- ReplaceSitesRequest: Request message for SiteService.ReplaceSites.
  - `advertiserId` string, int64: The ID of the advertiser that owns the parent channel.
  - `newSites` Site[]: The sites that will replace the existing sites assigned to the channel, specified as a list of Sites.
    - `name` string: Output only. The resource name of the site.
    - `urlOrAppId` string: Required. The app ID or URL of the site. Must be UTF-8 encoded with a maximum length of 240 bytes.
  - `partnerId` string, int64: The ID of the partner that owns the parent channel.

## Response `200`

Successful response

## Changes

- **2026-10-10** `52cdb4885336`: 2 breaking
  - removed the request body
  - removed the media type `*/*` for the response with the status `200`

[Operation history](https://skmtc.dev/google/apis/displayvideo/changes/v4/partners/:partnerId/channels/:channelId/sites:replace/post.md)

---

[API](https://skmtc.dev/google/apis/displayvideo.md) · [All operations](https://skmtc.dev/google/apis/displayvideo/llms.txt) · [OpenAPI document](https://skmtc.dev/google/apis/displayvideo/revisions/6329126f9fb6?raw)
