Update a discussion - GitHub API

Edits the title and body text of a discussion post. Only the parameters you provide are updated. 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}.

{ "author": { "avatar_url": "https://github.com/images/error/octocat_happy.gif", "events_url": "https://api.github.com/users/octocat/events{/privacy}", "followers_url": "https://api.github.com/users/octocat/followers", "following_url": "https://api.github.com/users/octocat/following{/other_user}", "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", "gravatar_id": "41d064eb2195891e12d0413f63227ea7", "html_url": "https://github.com/octocat", "id": 1, "login": "octocat", "node_id": "MDQ6VXNlcjE=", "organizations_url": "https://api.github.com/users/octocat/orgs", "received_events_url": "https://api.github.com/users/octocat/received_events", "repos_url": "https://api.github.com/users/octocat/repos", "site_admin": true, "starred_at": "\"2020-07-09T00:17:55Z\"", "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", "type": "User", "url": "https://api.github.com/users/octocat" }, "body": "Please suggest improvements to our workflow in comments.", "body_html": "<p>Hi! This is an area for us to collaborate as a team</p>", "body_version": "0307116bbf7ced493b8d8a346c650b71", "comments_count": 0, "comments_url": "https://api.github.com/organizations/1/team/2343027/discussions/1/comments", "created_at": "2018-01-25T18:56:31Z", "html_url": "https://github.com/orgs/github/teams/justice-league/discussions/1", "last_edited_at": "2019-08-24T14:15:22Z", "node_id": "MDE0OlRlYW1EaXNjdXNzaW9uMQ==", "number": 42, "pinned": true, "private": true, "reactions": { "+1": 0, "-1": 0, "confused": 0, "eyes": 0, "heart": 0, "hooray": 0, "laugh": 0, "rocket": 0, "total_count": 0, "url": "http://example.com" }, "team_url": "https://api.github.com/organizations/1/team/2343027", "title": "How can we improve our workflow?", "updated_at": "2018-01-25T18:56:31Z", "url": "https://api.github.com/organizations/1/team/2343027/discussions/1" }

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

org

string

必需

team_slug

string

必需

team_slug parameter

discussion_number

integer

必需

Body 参数application/json

body

string

可选

The discussion post's body text.

title

string

可选

The discussion post's title.

示例

返回响应

🟢200Response

application/json

Body

A team discussion is a persistent record of a free-form conversation within a team.

author

null

必需

Simple User

body

string

必需

The main text of the discussion.

示例值:

Please suggest improvements to our workflow in comments.

body_html

string

必需

示例值:

<p>Hi! This is an area for us to collaborate as a team</p>

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.

示例值:

0307116bbf7ced493b8d8a346c650b71

comments_count

integer

必需

示例值:

comments_url

string <uri>

必需

示例值:

https://api.github.com/organizations/1/team/2343027/discussions/1/comments

created_at

string <date-time>

必需

示例值:

2018-01-25T18:56:31Z

html_url

string <uri>

必需

示例值:

https://github.com/orgs/github/teams/justice-league/discussions/1

last_edited_at

string <date-time> | null

必需

node_id

string

必需

示例值:

MDE0OlRlYW1EaXNjdXNzaW9uMQ==

number

integer

必需

The unique sequence number of a team discussion.

示例值:

pinned

boolean

必需

Whether or not this discussion should be pinned for easy retrieval.

示例值:

true

private

boolean

必需

Whether or not this discussion should be restricted to team members and organization administrators.

示例值:

true

reactions

object (Reaction Rollup)

可选

integer

必需

-1

integer

必需

confused

integer

必需

eyes

integer

必需

heart

integer

必需

hooray

integer

必需

laugh

integer

必需

rocket

integer

必需

total_count

integer

必需

url

string <uri>

必需

team_url

string <uri>

必需

示例值:

https://api.github.com/organizations/1/team/2343027

title

string

必需

The title of the discussion.

示例值:

How can we improve our workflow?

updated_at

string <date-time>

必需

示例值:

2018-01-25T18:56:31Z

url

string <uri>

必需

示例值:

https://api.github.com/organizations/1/team/2343027/discussions/1