discussion_comments

Overview

Name	discussion_comments
Type	Resource
Id	github.teams.discussion_comments

Fields

Name	Datatype	Description
author	object	A GitHub user.
body	string	The main text of the comment.
body_html	string
body_version	string	The current version of the body content. If provided, this update operation will be rejected if the given version does not match the latest version on the server.
created_at	string
discussion_url	string
html_url	string
last_edited_at	string
node_id	string
number	integer	The unique sequence number of a team discussion comment.
reactions	object
updated_at	string
url	string

Methods

Name	Accessible by	Required Params	Description
get_discussion_comment_in_org	SELECT	comment_number, discussion_number, org, team_slug	Get a specific comment on a team discussion. OAuth access tokens require the read:discussion scope. Note: You can also specify a team by org_id and team_id using the route GET /organizations/{org_id}/team/{team_id}/discussions/{discussion_number}/comments/{comment_number}.
get_discussion_comment_legacy	SELECT	comment_number, discussion_number, team_id	Deprecation Notice: This endpoint route is deprecated and will be removed from the Teams API. We recommend migrating your existing code to use the new Get a discussion comment endpoint. Get a specific comment on a team discussion. OAuth access tokens require the read:discussion scope.
list_discussion_comments_in_org	SELECT	discussion_number, org, team_slug	List all comments on a team discussion. OAuth access tokens require the read:discussion scope. Note: You can also specify a team by org_id and team_id using the route GET /organizations/{org_id}/team/{team_id}/discussions/{discussion_number}/comments.
list_discussion_comments_legacy	SELECT	discussion_number, team_id	Deprecation Notice: This endpoint route is deprecated and will be removed from the Teams API. We recommend migrating your existing code to use the new List discussion comments endpoint. List all comments on a team discussion. OAuth access tokens require the read:discussion scope.
create_discussion_comment_in_org	INSERT	discussion_number, org, team_slug, data__body	Creates a new comment on a team discussion. OAuth access tokens require the write:discussion scope. This endpoint triggers notifications. Creating content too quickly using this endpoint may result in secondary rate limiting. See "Secondary rate limits" and "Dealing with secondary rate limits" for details. Note: You can also specify a team by org_id and team_id using the route POST /organizations/{org_id}/team/{team_id}/discussions/{discussion_number}/comments.
delete_discussion_comment_in_org	DELETE	comment_number, discussion_number, org, team_slug	Deletes a comment on a team discussion. OAuth access tokens require the write:discussion scope. Note: You can also specify a team by org_id and team_id using the route DELETE /organizations/{org_id}/team/{team_id}/discussions/{discussion_number}/comments/{comment_number}.
create_discussion_comment_legacy	EXEC	discussion_number, team_id, data__body	Deprecation Notice: This endpoint route is deprecated and will be removed from the Teams API. We recommend migrating your existing code to use the new Create a discussion comment endpoint. Creates a new comment on a team discussion. OAuth access tokens require the write:discussion scope. This endpoint triggers notifications. Creating content too quickly using this endpoint may result in secondary rate limiting. See "Secondary rate limits" and "Dealing with secondary rate limits" for details.
delete_discussion_comment_legacy	EXEC	comment_number, discussion_number, team_id	Deprecation Notice: This endpoint route is deprecated and will be removed from the Teams API. We recommend migrating your existing code to use the new Delete a discussion comment endpoint. Deletes a comment on a team discussion. OAuth access tokens require the write:discussion scope.
update_discussion_comment_in_org	EXEC	comment_number, discussion_number, org, team_slug, data__body	Edits the body text of a discussion comment. OAuth access tokens require the write:discussion scope. Note: You can also specify a team by org_id and team_id using the route PATCH /organizations/{org_id}/team/{team_id}/discussions/{discussion_number}/comments/{comment_number}.
update_discussion_comment_legacy	EXEC	comment_number, discussion_number, team_id, data__body	Deprecation Notice: This endpoint route is deprecated and will be removed from the Teams API. We recommend migrating your existing code to use the new Update a discussion comment endpoint. Edits the body text of a discussion comment. OAuth access tokens require the write:discussion scope.