CommentThreads: update

Modifies the top-level comment in a comment thread.

Quota impact: A call to this method has a quota cost of 50 units.

Common use cases


HTTP request



This request requires authorization with at least one of the following scopes (read more about authentication and authorization).



The following table lists the parameters that this query supports. All of the parameters listed are query parameters.

Required parameters
part string
The part parameter specifies a comma-separated list of commentThread resource properties that the API response will include. You must at least include the snippet part in the parameter value since that part contains all of the properties that the API request can update.

The following list contains the part names that you can include in the parameter value:
  • id
  • replies
  • snippet

Request body

Provide a commentThread resource in the request body.


If successful, this method returns a commentThread resource in the response body.


The following table identifies error messages that the API could return in response to a call to this method. Please see the error message documentation for more detail.

Error type Error detail Description
badRequest (400) commentTextTooLong The comment resource that is being inserted contains too many characters in the snippet.topLevelComment.snippet.textOriginal property.
badRequest (400) invalidCommentThreadMetadata The request metadata is invalid.
badRequest (400) operationNotSupported Only Google+ based comments can be updated.
badRequest (400) processingFailure The API server failed to successfully process the request. While this can be a transient error, it usually indicates that the request's input is invalid. Check the structure of the commentThread resource in the request body to ensure that it is valid.
forbidden (403) forbidden The comment thread could not be updated due to insufficient permissions. The request might not be properly authorized.
forbidden (403) ineligibleAccount The YouTube account used to authorize the API request must be merged with the user's Google account to update a comment or comment thread.
notFound (404) commentThreadNotFound The specified comment thread could not be found. Check the value of the id property in the request body to ensure that it is correct.

Try it!

Use the APIs Explorer to call this API and see the API request and response.