Discussions API

[avelino]

are there plans to implement api for discussions like teams discussions?

my need:
I'm moving public communication with my community (pREST) to discussions and i want to read the communications to list on the site

[becca]

Not yet but we're working towards providing one. This came up as well in #36.

[smorimoto]

Will something like has_discussions be added here after it's made generally available?
https://docs.github.com/en/free-pro-team@latest/rest/reference/repos#create-an-organization-repository--parameters

[GMallikarjunaRao]

I wan to work with Open Mp, MPI and GPU in colab can any one help me

[draidin135730]

hi my friends i am Dr.aidin jabariasl . i am veterinary medicine doctor.and nowdays work as second job i want learn and colaburate in github code and programing. i like cryptocurrency issue

[EliteMasterEric]

The Discussions appear to be in beta, so it seems like repository discussions will inevitably get an API once the structure of the feature is stable.

[draidin135730]

Please send me roadmap

[vanbroup]

While any API would already be really helpful, it would be great if you can upload RFC 822 messages similar as how you can import archives to Google Groups.

Specifically, we would like to migrate some Mailman .mbox archives to GitHub discussions.

[sull]

Is there an estimated timeline for an API? I am in a decision mode and my preference is to use repo discussion for my need but my workflow would require ability to post a new discussion via API (just the initial post, not full discussion). Alternatively, an API to do the conversion of an Issue to a Discussion would suffice and be a good stopgap solution until full API is ironed out (since I can make an issue via API already).

[bpmct]

I would love to be a part of the beta as well, if possible @evi-liu.

[matthewmueller]

I would also love to be part of the beta.

[msameen99]

Hi @evi-liu !, I would love to test this as well, thanks in advance

[josiauh]

@evi-liu i'd like to test!

[evi-liu]

The GraphQL API has been released and anyone may try it out now! See this comment for details.

[michaelsena]

This would be great. We're considering to use Discussions for our open source communities, but it's important that we can use webhooks to grab all discussion events (new, comment, reply, etc) and post them in a channel in our Discord community chat.

[evi-liu]

Private beta for Discussions GraphQL API available

🎉 We now have a private beta available for our Discussions GraphQL API. Please see our documentation for what capabilities are available and note that when making GraphQL requests, you'll need to include the GraphQL-Features: discussions_api HTTP header.

Please note that webhooks are not available yet, but our team is actively working on them to make available soon.

If you'd like to try out the private beta, please reply to this thread and I'll flag you in. I am limiting to the first 15 responders for now.

[mktcode]

@nul800sebastiaan @laymonage But I believe you still need to set the header: "GraphQL-Features": "discussions_api" (not sure though, can't test it right now)

[laymonage]

@mktcode No, that's no longer necessary. You even left a comment on the announcement 😉

I'm using it on my project and it works fine.

[mktcode]

lol :D

[josiauh]

okok,

[dperolio]

Any new info available on the webhooks situation?

[sull]

Please flag me

…

On Thu, Feb 4, 2021 at 7:59 PM Evi Liu ***@***.***> wrote: Private beta for Discussions GraphQL API available 🎉 We now have a private beta available for our Discussions GraphQL API. Please see our documentation <https://gist.github.com/smashwilson/311e1487ddb40a455fc54d294cc63ad4> for what capabilities are available and note that when making GraphQL requests, you'll need to include the GraphQL-Features: discussions_api HTTP header. Please note that webhooks are not available yet, but our team is actively working on them to make available soon. If you'd like to try out the private beta, please reply to this thread and I'll flag you in. I am limiting to the first 15 responders for now. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#43 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAABVMVW3S3BMQ6G2EO7ONDS5M7IXANCNFSM4TIWEQOQ> .

[evi-liu]

flagged you in!

[whydnxx]

Please flag me 😉

[evi-liu]

@whydnxx flagged in!

[evi-liu]

🎉 Discussions GraphQL API now available!

Great news, everyone! The Discussions GraphQL API is now shipped and available for use. See our documentation for how to get started.

[mktcode]

@rockrzhackrz I found this: https://lucasconstantino.github.io/graphiql-online/

[laymonage]

@SuspiciousLookingOwl @mktcode The docs aren't up to date as they're still actively developing the API. For example, you used to be able to upvote and downvote comments, and you'd use something like a netUpvoteCount. Now they only allow you to upvote, and you can access the value using the upvoteCount attribute in a Discussion/DiscussionComment.

For the latest version of the API, you can download the schema using the method I've shared here.

Here's the latest one for DiscussionComment, you can see there's an upvoteCount: Int! field in it.

type DiscussionComment

"""
A comment on a discussion.
"""
type DiscussionComment implements Comment & Deletable & Minimizable & Node & Reactable & Updatable & UpdatableComment & Votable {
  """
  The actor who authored the comment.
  """
  author: Actor

  """
  Author's association with the subject of the comment.
  """
  authorAssociation: CommentAuthorAssociation!

  """
  The body as Markdown.
  """
  body: String!

  """
  The body rendered to HTML.
  """
  bodyHTML: HTML!

  """
  The body rendered to text.
  """
  bodyText: String!

  """
  Identifies the date and time when the object was created.
  """
  createdAt: DateTime!

  """
  Check if this comment was created via an email reply.
  """
  createdViaEmail: Boolean!

  """
  Identifies the primary key from the database.
  """
  databaseId: Int

  """
  The time when this replied-to comment was deleted
  """
  deletedAt: DateTime

  """
  The discussion this comment was created in
  """
  discussion: Discussion

  """
  The actor who edited the comment.
  """
  editor: Actor
  id: ID!

  """
  Check if this comment was edited and includes an edit with the creation data
  """
  includesCreatedEdit: Boolean!

  """
  Has this comment been chosen as the answer of its discussion?
  """
  isAnswer: Boolean!

  """
  Returns whether or not a comment has been minimized.
  """
  isMinimized: Boolean!

  """
  The moment the editor made the last edit
  """
  lastEditedAt: DateTime

  """
  Returns why the comment was minimized.
  """
  minimizedReason: String

  """
  Identifies when the comment was published at.
  """
  publishedAt: DateTime

  """
  A list of reactions grouped by content left on the subject.
  """
  reactionGroups: [ReactionGroup!]

  """
  A list of Reactions left on the Issue.
  """
  reactions(
    """
    Returns the elements in the list that come after the specified cursor.
    """
    after: String

    """
    Returns the elements in the list that come before the specified cursor.
    """
    before: String

    """
    Allows filtering Reactions by emoji.
    """
    content: ReactionContent

    """
    Returns the first _n_ elements from the list.
    """
    first: Int

    """
    Returns the last _n_ elements from the list.
    """
    last: Int

    """
    Allows specifying the order in which reactions are returned.
    """
    orderBy: ReactionOrder
  ): ReactionConnection!

  """
  The threaded replies to this comment.
  """
  replies(
    """
    Returns the elements in the list that come after the specified cursor.
    """
    after: String

    """
    Returns the elements in the list that come before the specified cursor.
    """
    before: String

    """
    Returns the first _n_ elements from the list.
    """
    first: Int

    """
    Returns the last _n_ elements from the list.
    """
    last: Int
  ): DiscussionCommentConnection!

  """
  The discussion comment this comment is a reply to
  """
  replyTo: DiscussionComment

  """
  The path for this discussion comment.
  """
  resourcePath: URI!

  """
  Identifies the date and time when the object was last updated.
  """
  updatedAt: DateTime!

  """
  Number of upvotes that this subject has received.
  """
  upvoteCount: Int!

  """
  The URL for this discussion comment.
  """
  url: URI!

  """
  A list of edits to this content.
  """
  userContentEdits(
    """
    Returns the elements in the list that come after the specified cursor.
    """
    after: String

    """
    Returns the elements in the list that come before the specified cursor.
    """
    before: String

    """
    Returns the first _n_ elements from the list.
    """
    first: Int

    """
    Returns the last _n_ elements from the list.
    """
    last: Int
  ): UserContentEditConnection

  """
  Check if the current viewer can delete this object.
  """
  viewerCanDelete: Boolean!

  """
  Can the current user mark this comment as an answer?
  """
  viewerCanMarkAsAnswer: Boolean!

  """
  Check if the current viewer can minimize this object.
  """
  viewerCanMinimize: Boolean!

  """
  Can user react to this subject
  """
  viewerCanReact: Boolean!

  """
  Can the current user unmark this comment as an answer?
  """
  viewerCanUnmarkAsAnswer: Boolean!

  """
  Check if the current viewer can update this object.
  """
  viewerCanUpdate: Boolean!

  """
  Whether or not the current user can add or remove an upvote on this subject.
  """
  viewerCanUpvote: Boolean!

  """
  Reasons why the current viewer can not update this comment.
  """
  viewerCannotUpdateReasons: [CommentCannotUpdateReason!]!

  """
  Did the viewer author this comment.
  """
  viewerDidAuthor: Boolean!

  """
  Whether or not the current user has already upvoted this subject.
  """
  viewerHasUpvoted: Boolean!
}

[SuspiciousLookingOwl]

@laymonage upvoteCount works, terima kasih!

[surjithctly]

Is there any plans for the REST API? @evi-liu ?

[Lite5h4dow]

rest api?

[laymonage]

It is currently impossible to use the API from a web browser. See #3622.

[pattacini]

Any news regarding the REST API?

[Bibo-Joshi]

#4327 (comment)

[pattacini]

Ouch.. that's a pity.
Thanks for posting!

[aleks-ivanov]

Assuming you could do the same GET/POST actions with GraphQL, I see that as a win 🙂

[pattacini]

Well, when you have an extensive codebase written in REST API (not limited to this request) that you need to port to GrapQL sooner or later is not a win in the short term 😏

[starsalon]

are there plans to implement api for discussions like teams discussions?

my need:
I'm moving public communication with my community (pREST) to discussions and i want to read the communications to list on the site

I am trying to implement api for my website https://epesa.in/. It is payment platform. I need help.

[philip-gai]

Here is an example of me using the graphql api from a node app with typescript:

1. Get repo discussion categories
2. Create a repo discussion
3. Create an org team discussion

This was for my GitHub App Announcement Drafter that allows you to draft and create discussions using pull requests!

[aleks-ivanov]

I would LOVE a Discussions API, similar to the Issues one 🙂

[aleks-ivanov]

#4327 (comment)

[devstein]

Hi all 👋 I read through this thread and have two questions

1. Is there a way to convert an issue to discussion or vice-versa via the GraphQL API?
2. Is there a way to know if a discussion was created from an issue via the GraphQL or REST API?

Any help is appreciated!

[abhi-iac]

I am in a same boat. Banged my head searching through gh REST documentation for discussion REST API. Now that I can see it is not available I might search for the GraphQL options.