PUT /youtube/v3/liveStreams – Google YouTube Data API v3

abuseReports1

activities1

captions5

channelBanners1

channels2

channelSections4

comments6

commentThreads2

i18nLanguages1

i18nRegions1

liveBroadcasts7

liveChatBans2

liveChatMessages4

liveChatModerators3

liveStreams4

members1

membershipsLevels1

playlistImages4

playlistItems4

playlists4

search1

subscriptions3

superChatEvents1

tests1

thirdPartyLinks4

thumbnails1

videoAbuseReportReasons1

videoCategories1

videos8

videoTrainability1

watermarks2

youtube1

liveStreams

Changed on Oct 13, 2026

Updates an existing stream for the authenticated user.

put/youtube/v3/liveStreams

Request

Base URL: https://youtube.googleapis.com
URL: https://youtube.googleapis.com/youtube/v3/liveStreams
Auth: one of:
- OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/youtube) 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/youtube)
- OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/youtube.force-ssl) 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/youtube.force-ssl)

Query parameters

partstring[] required

The part parameter serves two purposes in this operation. It identifies the properties that the write operation will set as well as the properties that the API response will include. The part properties that you can include in the parameter value are id, snippet, cdn, and status. Note that this method will override the existing values for all of the mutable properties that are contained in any parts that the parameter value specifies. If the request body does not specify a value for a mutable property, the existing value for that property will be removed.

onBehalfOfContentOwnerstring

Note: This parameter is intended exclusively for YouTube content partners. The onBehalfOfContentOwner parameter indicates that the request's authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data, without having to provide authentication credentials for each individual channel. The CMS account that the user authenticates with must be linked to the specified YouTube content owner.

onBehalfOfContentOwnerChannelstring

This parameter can only be used in a properly authorized request. Note: This parameter is intended exclusively for YouTube content partners. The onBehalfOfContentOwnerChannel parameter specifies the YouTube channel ID of the channel to which a video is being added. This parameter is required when a request specifies a value for the onBehalfOfContentOwner parameter, and it can only be used in conjunction with that parameter. In addition, the request must be authorized using a CMS account that is linked to the content owner that the onBehalfOfContentOwner parameter specifies. Finally, the channel that the onBehalfOfContentOwnerChannel parameter value specifies must be linked to the content owner that the onBehalfOfContentOwner parameter specifies. This parameter is intended for YouTube content partners that own and manage many different YouTube channels. It allows content owners to authenticate once and perform actions on behalf of the channel specified in the parameter value, without having to provide authentication credentials for each separate channel.

Request body

etagstring

Etag of this resource.

idstring

The ID that YouTube assigns to uniquely identify the stream.

kindstring

Identifies what kind of resource this is. Value: the fixed string "youtube#liveStream".

Response

Successful response

Changes

Oct 13, 2026a62cce9a7aac Revision changes
- info
  the security scope https://www.googleapis.com/auth/youtube was added to the endpoint's security scheme Oauth2
- info
  the security scope https://www.googleapis.com/auth/youtube was added to the endpoint's security scheme Oauth2c
- info
  the security scope https://www.googleapis.com/auth/youtube.force-ssl was removed from the endpoint's security scheme Oauth2
- info
  the security scope https://www.googleapis.com/auth/youtube.force-ssl was removed from the endpoint's security scheme Oauth2c
Oct 10, 20265f5aee36c620 Revision changes
- breaking
  removed the request body
- breaking
  removed the media type */* for the response with the status
- info
  the security scope https://www.googleapis.com/auth/youtube was added to the endpoint's security scheme Oauth2
- info
  the security scope https://www.googleapis.com/auth/youtube was added to the endpoint's security scheme Oauth2c
- info
  the security scope https://www.googleapis.com/auth/youtube.force-ssl was removed from the endpoint's security scheme Oauth2
- info
  the security scope https://www.googleapis.com/auth/youtube.force-ssl was removed from the endpoint's security scheme Oauth2c

Operation history (3 revisions)