{"meta":{"title":"Utilisation de l’API GraphQL pour les discussions","intro":"Découvrez comment utiliser l’API GitHub Discussions GraphQL.","product":"GraphQL API","breadcrumbs":[{"href":"/fr/graphql","title":"GraphQL API"},{"href":"/fr/graphql/guides","title":"Guides"},{"href":"/fr/graphql/guides/using-the-graphql-api-for-discussions","title":"Utiliser GraphQL pour les discussions"}],"documentType":"article"},"body":"# Utilisation de l’API GraphQL pour les discussions\n\nDécouvrez comment utiliser l’API GitHub Discussions GraphQL.\n\nL’API GitHub Discussions GraphQL vous permet d’obtenir, de créer, de modifier et de supprimer des billets de discussion. Pour plus d’informations sur GitHub Discussions, consultez [À propos des discussions](/fr/discussions/collaborating-with-your-community-using-discussions/about-discussions).\n\nCette API est disponible pour les utilisateurs authentifiés, OAuth apps et les applications GitHub. Les jetons d’accès nécessitent l’étendue `repo` pour les dépôts privés et l’étendue `public_repo` pour les dépôts publics. Pour plus d’informations, consultez « [Étendues des applications OAuth](/fr/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps) ».\n\n## Champs\n\n### Repository.discussions\n\nLister les discussions au sein d’un dépôt. Si `categoryId` est spécifié, seuls les résultats de cette catégorie seront retournés. Si `answered` n’est pas spécifié, les discussions avec ou sans réponse seront retournées.\n\n*Signature :*\n\n```graphql\ndiscussions(\n  after: String,\n  before: String,\n  first: Int,\n  last: Int,\n  categoryId: ID = null,\n  \n  answered: Boolean = null,\n  \n  orderBy: DiscussionOrder = {field: UPDATED_AT, direction: DESC}\n) : Discussion\n```\n\n#### OrdreDeDiscussion\n\n```graphql\n\"\"\"\nWays in which discussions can be ordered.\n\"\"\"\ninput DiscussionOrder {\n  \"\"\"\n  The field by which to order discussions.\n  \"\"\"\n  field: DiscussionOrderField!\n\n  \"\"\"\n  The direction in which to order discussions by the specified field.\n  \"\"\"\n  direction: OrderDirection!\n}\n```\n\n```graphql\n\"\"\"\nProperties by which discussion connections can be ordered.\n\"\"\"\nenum DiscussionOrderField {\n  \"\"\"\n  Order discussions by creation time.\n  \"\"\"\n  CREATED_AT\n\n  \"\"\"\n  Order discussions by most recent modification time.\n  \"\"\"\n  UPDATED_AT\n}\n```\n\n### Repository.discussionCategories\n\nRetourner les catégories de discussion disponibles définies dans ce dépôt. Chaque référentiel peut avoir jusqu’à 25 catégories. Pour plus d’informations sur les catégories de discussion, consultez [Gestion de catégories pour les discussions](/fr/discussions/managing-discussions-for-your-community/managing-categories-for-discussions#about-categories-for-discussions).\n\n*Signature :*\n\n```graphql\ndiscussionCategories(\n  after: String,\n  before: String,\n  first: Int,\n  last: Int,\n) : DiscussionCategoryConnection!\n```\n\n### Repository.discussion\n\nEngager une discussion. Retourne `null` si la discussion avec l’ID spécifié n’existe pas.\n\n*Signature :*\n\n```graphql\ndiscussion(number: Int!) : Discussion\n```\n\n### Repository.pinnedDiscussions\n\nRetourner des discussions épinglées à ce dépôt, classées d’après la position des épingles.\n\n*Signature :*\n\n```graphql\npinnedDiscussions(\n  after: String,\n  before: String,\n  first: Int,\n  last: Int,\n) : PinnedDiscussionConnection!\n```\n\n## Objets\n\n**Remarque :** Par souci de concision, les types de connexion ne sont pas développés ici. Chaque type de connexion mentionné dans le schéma suit le même modèle que les autres connexions dans l’API GraphQL. Pour plus d’informations, consultez « [Présentation de GraphQL](/fr/graphql/guides/introduction-to-graphql#connection) ».\n\n```graphql\nquery {\n  repository(owner: \"github\", name: \"some-repo\") {\n    discussions(first: 10) {\n      # type: DiscussionConnection\n      totalCount # Int!\n\n      pageInfo {\n        # type: PageInfo (from the public schema)\n        startCursor\n        endCursor\n        hasNextPage\n        hasPreviousPage\n      }\n\n      edges {\n        # type: DiscussionEdge\n        cursor\n        node {\n          # type: Discussion\n          id\n        }\n      }\n\n      nodes {\n        # type: Discussion\n        id\n      }\n    }\n  }\n}\n```\n\n### Discussion\n\n<details>\n<summary>champs :</summary>\n\n```graphql\n\"\"\"\nA discussion in a repository.\n\"\"\"\ntype Discussion implements Comment & Deletable & Lockable & Node & Reactable & RepositoryNode & Subscribable & Updatable {\n  \"\"\"\n  Reason that the conversation was locked.\n  \"\"\"\n  activeLockReason: LockReason\n\n  \n  \"\"\"\n  Check if this discussion has been answered\n  \"\"\"\n  isAnswered: Boolean!\n  \n\n  \"\"\"\n  The comment chosen as this discussion's answer, if any.\n  \"\"\"\n  answer: DiscussionComment\n\n  \"\"\"\n  The time when a user chose this discussion's answer, if answered.\n  \"\"\"\n  answerChosenAt: DateTime\n\n  \"\"\"\n  The user who chose this discussion's answer, if answered.\n  \"\"\"\n  answerChosenBy: Actor\n\n  \"\"\"\n  The actor who authored the comment.\n  \"\"\"\n  author: Actor\n\n  \"\"\"\n  Author's association with the subject of the comment.\n  \"\"\"\n  authorAssociation: CommentAuthorAssociation!\n\n  \"\"\"\n  The main text of the discussion post.\n  \"\"\"\n  body: String!\n\n  \"\"\"\n  The body rendered to HTML.\n  \"\"\"\n  bodyHTML: HTML!\n\n  \"\"\"\n  The body rendered to text.\n  \"\"\"\n  bodyText: String!\n\n  \"\"\"\n  The category for this discussion.\n  \"\"\"\n  category: DiscussionCategory!\n\n  \"\"\"\n  The replies to the discussion.\n  \"\"\"\n  comments(\n    \"\"\"\n    Returns the elements in the list that come after the specified cursor.\n    \"\"\"\n    after: String\n\n    \"\"\"\n    Returns the elements in the list that come before the specified cursor.\n    \"\"\"\n    before: String\n\n    \"\"\"\n    Returns the first _n_ elements from the list.\n    \"\"\"\n    first: Int\n\n    \"\"\"\n    Returns the last _n_ elements from the list.\n    \"\"\"\n    last: Int\n  ): DiscussionCommentConnection!\n\n  \"\"\"\n  Identifies the date and time when the object was created.\n  \"\"\"\n  createdAt: DateTime!\n\n  \"\"\"\n  Check if this comment was created via an email reply.\n  \"\"\"\n  createdViaEmail: Boolean!\n\n  \"\"\"\n  Identifies the primary key from the database.\n  \"\"\"\n  databaseId: Int\n\n  \"\"\"\n  The actor who edited the comment.\n  \"\"\"\n  editor: Actor\n  id: ID!\n\n  \"\"\"\n  Check if this comment was edited and includes an edit with the creation data\n  \"\"\"\n  includesCreatedEdit: Boolean!\n\n  \"\"\"\n  The moment the editor made the last edit\n  \"\"\"\n  lastEditedAt: DateTime\n\n  \"\"\"\n  `true` if the object is locked\n  \"\"\"\n  locked: Boolean!\n\n  \"\"\"\n  The number identifying this discussion within the repository.\n  \"\"\"\n  number: Int!\n\n  \"\"\"\n  Identifies when the comment was published at.\n  \"\"\"\n  publishedAt: DateTime\n\n  \"\"\"\n  A list of reactions grouped by content left on the subject.\n  \"\"\"\n  reactionGroups: [ReactionGroup!]\n\n  \"\"\"\n  A list of Reactions left on the Issue.\n  \"\"\"\n  reactions(\n    \"\"\"\n    Returns the elements in the list that come after the specified cursor.\n    \"\"\"\n    after: String\n\n    \"\"\"\n    Returns the elements in the list that come before the specified cursor.\n    \"\"\"\n    before: String\n\n    \"\"\"\n    Allows filtering Reactions by emoji.\n    \"\"\"\n    content: ReactionContent\n\n    \"\"\"\n    Returns the first _n_ elements from the list.\n    \"\"\"\n    first: Int\n\n    \"\"\"\n    Returns the last _n_ elements from the list.\n    \"\"\"\n    last: Int\n\n    \"\"\"\n    Allows specifying the order in which reactions are returned.\n    \"\"\"\n    orderBy: ReactionOrder\n  ): ReactionConnection!\n\n  \"\"\"\n  The repository associated with this node.\n  \"\"\"\n  repository: Repository!\n\n  \"\"\"\n  The path for this discussion.\n  \"\"\"\n  resourcePath: URI!\n\n  \"\"\"\n  The title of this discussion.\n  \"\"\"\n  title: String!\n\n  \"\"\"\n  Identifies the date and time when the object was last updated.\n  \"\"\"\n  updatedAt: DateTime!\n\n  \"\"\"\n  The URL for this discussion.\n  \"\"\"\n  url: URI!\n\n  \"\"\"\n  A list of edits to this content.\n  \"\"\"\n  userContentEdits(\n    \"\"\"\n    Returns the elements in the list that come after the specified cursor.\n    \"\"\"\n    after: String\n\n    \"\"\"\n    Returns the elements in the list that come before the specified cursor.\n    \"\"\"\n    before: String\n\n    \"\"\"\n    Returns the first _n_ elements from the list.\n    \"\"\"\n    first: Int\n\n    \"\"\"\n    Returns the last _n_ elements from the list.\n    \"\"\"\n    last: Int\n  ): UserContentEditConnection\n\n  \"\"\"\n  Check if the current viewer can delete this object.\n  \"\"\"\n  viewerCanDelete: Boolean!\n\n  \"\"\"\n  Can user react to this subject\n  \"\"\"\n  viewerCanReact: Boolean!\n\n  \"\"\"\n  Check if the viewer is able to change their subscription status for the repository.\n  \"\"\"\n  viewerCanSubscribe: Boolean!\n\n  \"\"\"\n  Check if the current viewer can update this object.\n  \"\"\"\n  viewerCanUpdate: Boolean!\n\n  \"\"\"\n  Did the viewer author this comment.\n  \"\"\"\n  viewerDidAuthor: Boolean!\n\n  \"\"\"\n  Identifies if the viewer is watching, not watching, or ignoring the subscribable entity.\n  \"\"\"\n  viewerSubscription: SubscriptionState\n}\n```\n\n</details>\n\n### DiscussionCommentaire\n\n<details>\n<summary>Champs</summary>\n\n```graphql\n\"\"\"\nA comment on a discussion.\n\"\"\"\ntype DiscussionComment implements Comment & Deletable & Minimizable & Node & Reactable & Updatable & UpdatableComment {\n  \"\"\"\n  The actor who authored the comment.\n  \"\"\"\n  author: Actor\n\n  \"\"\"\n  Author's association with the subject of the comment.\n  \"\"\"\n  authorAssociation: CommentAuthorAssociation!\n\n  \"\"\"\n  The body as Markdown.\n  \"\"\"\n  body: String!\n\n  \"\"\"\n  The body rendered to HTML.\n  \"\"\"\n  bodyHTML: HTML!\n\n  \"\"\"\n  The body rendered to text.\n  \"\"\"\n  bodyText: String!\n\n  \"\"\"\n  Identifies the date and time when the object was created.\n  \"\"\"\n  createdAt: DateTime!\n\n  \"\"\"\n  Check if this comment was created via an email reply.\n  \"\"\"\n  createdViaEmail: Boolean!\n\n  \"\"\"\n  Identifies the primary key from the database.\n  \"\"\"\n  databaseId: Int\n\n  \"\"\"\n  The time when this replied-to comment was deleted\n  \"\"\"\n  deletedAt: DateTime\n\n  \"\"\"\n  The discussion this comment was created in\n  \"\"\"\n  discussion: Discussion\n\n  \"\"\"\n  The actor who edited the comment.\n  \"\"\"\n  editor: Actor\n  id: ID!\n\n  \"\"\"\n  Check if this comment was edited and includes an edit with the creation data\n  \"\"\"\n  includesCreatedEdit: Boolean!\n\n  \"\"\"\n  Has this comment been chosen as the answer of its discussion?\n  \"\"\"\n  isAnswer: Boolean!\n\n  \"\"\"\n  Returns whether or not a comment has been minimized.\n  \"\"\"\n  isMinimized: Boolean!\n\n  \"\"\"\n  The moment the editor made the last edit\n  \"\"\"\n  lastEditedAt: DateTime\n\n  \"\"\"\n  Returns why the comment was minimized.\n  \"\"\"\n  minimizedReason: String\n\n  \"\"\"\n  Identifies when the comment was published at.\n  \"\"\"\n  publishedAt: DateTime\n\n  \"\"\"\n  A list of reactions grouped by content left on the subject.\n  \"\"\"\n  reactionGroups: [ReactionGroup!]\n\n  \"\"\"\n  A list of Reactions left on the Issue.\n  \"\"\"\n  reactions(\n    \"\"\"\n    Returns the elements in the list that come after the specified cursor.\n    \"\"\"\n    after: String\n\n    \"\"\"\n    Returns the elements in the list that come before the specified cursor.\n    \"\"\"\n    before: String\n\n    \"\"\"\n    Allows filtering Reactions by emoji.\n    \"\"\"\n    content: ReactionContent\n\n    \"\"\"\n    Returns the first _n_ elements from the list.\n    \"\"\"\n    first: Int\n\n    \"\"\"\n    Returns the last _n_ elements from the list.\n    \"\"\"\n    last: Int\n\n    \"\"\"\n    Allows specifying the order in which reactions are returned.\n    \"\"\"\n    orderBy: ReactionOrder\n  ): ReactionConnection!\n\n  \"\"\"\n  The threaded replies to this comment.\n  \"\"\"\n  replies(\n    \"\"\"\n    Returns the elements in the list that come after the specified cursor.\n    \"\"\"\n    after: String\n\n    \"\"\"\n    Returns the elements in the list that come before the specified cursor.\n    \"\"\"\n    before: String\n\n    \"\"\"\n    Returns the first _n_ elements from the list.\n    \"\"\"\n    first: Int\n\n    \"\"\"\n    Returns the last _n_ elements from the list.\n    \"\"\"\n    last: Int\n  ): DiscussionCommentConnection!\n\n  \"\"\"\n  The discussion comment this comment is a reply to\n  \"\"\"\n  replyTo: DiscussionComment\n\n  \"\"\"\n  The path for this discussion comment.\n  \"\"\"\n  resourcePath: URI!\n\n  \"\"\"\n  Identifies the date and time when the object was last updated.\n  \"\"\"\n  updatedAt: DateTime!\n\n  \"\"\"\n  The URL for this discussion comment.\n  \"\"\"\n  url: URI!\n\n  \"\"\"\n  A list of edits to this content.\n  \"\"\"\n  userContentEdits(\n    \"\"\"\n    Returns the elements in the list that come after the specified cursor.\n    \"\"\"\n    after: String\n\n    \"\"\"\n    Returns the elements in the list that come before the specified cursor.\n    \"\"\"\n    before: String\n\n    \"\"\"\n    Returns the first _n_ elements from the list.\n    \"\"\"\n    first: Int\n\n    \"\"\"\n    Returns the last _n_ elements from the list.\n    \"\"\"\n    last: Int\n  ): UserContentEditConnection\n\n  \"\"\"\n  Check if the current viewer can delete this object.\n  \"\"\"\n  viewerCanDelete: Boolean!\n\n  \"\"\"\n  Can the current user mark this comment as an answer?\n  \"\"\"\n  viewerCanMarkAsAnswer: Boolean!\n\n  \"\"\"\n  Check if the current viewer can minimize this object.\n  \"\"\"\n  viewerCanMinimize: Boolean!\n\n  \"\"\"\n  Can user react to this subject\n  \"\"\"\n  viewerCanReact: Boolean!\n\n  \"\"\"\n  Can the current user unmark this comment as an answer?\n  \"\"\"\n  viewerCanUnmarkAsAnswer: Boolean!\n\n  \"\"\"\n  Check if the current viewer can update this object.\n  \"\"\"\n  viewerCanUpdate: Boolean!\n\n  \"\"\"\n  Reasons why the current viewer can not update this comment.\n  \"\"\"\n  viewerCannotUpdateReasons: [CommentCannotUpdateReason!]!\n\n  \"\"\"\n  Did the viewer author this comment.\n  \"\"\"\n  viewerDidAuthor: Boolean!\n}\n```\n\n</details>\n\n### CatégorieDiscussion\n\n<details>\n<summary>Champs</summary>\n\n```graphql\n\"\"\"\nA category for discussions in a repository.\n\"\"\"\ntype DiscussionCategory implements Node & RepositoryNode {\n  \"\"\"\n  Identifies the date and time when the object was created.\n  \"\"\"\n  createdAt: DateTime!\n\n  \"\"\"\n  A description of this category.\n  \"\"\"\n  description: String\n\n  \"\"\"\n  An emoji representing this category.\n  \"\"\"\n  emoji: String!\n\n  \"\"\"\n  This category's emoji rendered as HTML.\n  \"\"\"\n  emojiHTML: HTML!\n  id: ID!\n\n  \"\"\"\n  Whether or not discussions in this category support choosing an answer with the markDiscussionCommentAsAnswer mutation.\n  \"\"\"\n  isAnswerable: Boolean!\n\n  \"\"\"\n  The name of this category.\n  \"\"\"\n  name: String!\n\n  \"\"\"\n  The repository associated with this node.\n  \"\"\"\n  repository: Repository!\n\n  \"\"\"\n  Identifies the date and time when the object was last updated.\n  \"\"\"\n  updatedAt: DateTime!\n}\n```\n\n</details>\n\n### PinnedDiscussion\n\n<details>\n<summary>champs :</summary>\n\n```graphql\n\"\"\"\nA Pinned discussion is a discussion pinned to a repository's index page.\n\"\"\"\ntype PinnedDiscussion implements Node & RepositoryNode {\n  \"\"\"\n  Identifies the date and time when the object was created.\n  \"\"\"\n  createdAt: DateTime!\n\n  \"\"\"\n  Identifies the primary key from the database.\n  \"\"\"\n  databaseId: Int\n\n  \"\"\"\n  The discussion that was pinned.\n  \"\"\"\n  discussion: Discussion!\n\n  \"\"\"\n  Color stops of the chosen gradient\n  \"\"\"\n  gradientStopColors: [String!]!\n  id: ID!\n\n  \"\"\"\n  Background texture pattern\n  \"\"\"\n  pattern: PinnedDiscussionPattern!\n\n  \"\"\"\n  The actor that pinned this discussion.\n  \"\"\"\n  pinnedBy: Actor!\n\n  \"\"\"\n  Preconfigured background gradient option\n  \"\"\"\n  preconfiguredGradient: PinnedDiscussionGradient\n\n  \"\"\"\n  The repository associated with this node.\n  \"\"\"\n  repository: Repository!\n\n  \"\"\"\n  Identifies the date and time when the object was last updated.\n  \"\"\"\n  updatedAt: DateTime!\n}\n```\n\n</details>\n\n#### PinnedDiscussionPattern\n\n<details>\n<summary>Valeurs</summary>\n\n```graphql\n\"\"\"\nPreconfigured background patterns that may be used to style discussions pinned within a repository.\n\"\"\"\nenum PinnedDiscussionPattern {\n  \"\"\"\n  An upward-facing chevron pattern\n  \"\"\"\n  CHEVRON_UP\n\n  \"\"\"\n  A hollow dot pattern\n  \"\"\"\n  DOT\n\n  \"\"\"\n  A solid dot pattern\n  \"\"\"\n  DOT_FILL\n\n  \"\"\"\n  A heart pattern\n  \"\"\"\n  HEART_FILL\n\n  \"\"\"\n  A friendly octocat face pattern\n  \"\"\"\n  OCTOFACE\n\n  \"\"\"\n  A plus sign pattern\n  \"\"\"\n  PLUS\n}\n```\n\n</details>\n\n#### PinnedDiscussionGradient\n\n<details>\n<summary>Valeurs</summary>\n\n```graphql\n\"\"\"\nPreconfigured gradients that may be used to style discussions pinned within a repository.\n\"\"\"\nenum PinnedDiscussionGradient {\n  \"\"\"\n  A gradient of blue to mint\n  \"\"\"\n  BLUE_MINT\n\n  \"\"\"\n  A gradient of blue to purple\n  \"\"\"\n  BLUE_PURPLE\n\n  \"\"\"\n  A gradient of pink to blue\n  \"\"\"\n  PINK_BLUE\n\n  \"\"\"\n  A gradient of purple to coral\n  \"\"\"\n  PURPLE_CORAL\n\n  \"\"\"\n  A gradient of red to orange\n  \"\"\"\n  RED_ORANGE\n}\n```\n\n</details>\n\n## Interfaces\n\n### RepositoryDiscussionAuthor\n\nImplémenté par les types `User` et `Organization`.\n**Remarque :** Des discussions seront associées à un élément `Organization` uniquement si ce dernier a été converti à partir d’un élément `User`.\n\n<details>\n<summary>Champs</summary>\n\n```graphql\n\"\"\"\nRepresents an author of discussions in repositories.\n\"\"\"\ninterface RepositoryDiscussionAuthor {\n  \"\"\"\n  Discussions this user has started.\n  \"\"\"\n  repositoryDiscussions(\n    \"\"\"\n    Returns the elements in the list that come after the specified cursor.\n    \"\"\"\n    after: String\n\n    \"\"\"\n    Filter discussions to only those that have been answered or not. Defaults to\n    including both answered and unanswered discussions.\n    \"\"\"\n    answered: Boolean = null\n\n    \"\"\"\n    Returns the elements in the list that come before the specified cursor.\n    \"\"\"\n    before: String\n\n    \"\"\"\n    Returns the first _n_ elements from the list.\n    \"\"\"\n    first: Int\n\n    \"\"\"\n    Returns the last _n_ elements from the list.\n    \"\"\"\n    last: Int\n\n    \"\"\"\n    Ordering options for discussions returned from the connection.\n    \"\"\"\n    orderBy: DiscussionOrder = {field: CREATED_AT, direction: DESC}\n\n    \"\"\"\n    Filter discussions to only those in a specific repository.\n    \"\"\"\n    repositoryId: ID\n  ): DiscussionConnection!\n}\n```\n\n</details>\n\n### RepositoryDiscussionCommentAuthor\n\nÉgalement implémenté par les types `User` et `Organization`.\n\n<details>\n<summary>Champs</summary>\n\n```graphql\n\"\"\"\nRepresents an author of discussion comments in repositories.\n\"\"\"\ninterface RepositoryDiscussionCommentAuthor {\n  \"\"\"\n  Discussion comments this user has authored.\n  \"\"\"\n  repositoryDiscussionComments(\n    \"\"\"\n    Returns the elements in the list that come after the specified cursor.\n    \"\"\"\n    after: String\n\n    \"\"\"\n    Returns the elements in the list that come before the specified cursor.\n    \"\"\"\n    before: String\n\n    \"\"\"\n    Returns the first _n_ elements from the list.\n    \"\"\"\n    first: Int\n\n    \"\"\"\n    Returns the last _n_ elements from the list.\n    \"\"\"\n    last: Int\n\n    \"\"\"\n    Filter discussion comments to only those that were marked as the answer\n    \"\"\"\n    onlyAnswers: Boolean = false\n\n    \"\"\"\n    Filter discussion comments to only those in a specific repository.\n    \"\"\"\n    repositoryId: ID\n  ): DiscussionCommentConnection!\n}\n```\n\n</details>\n\n## Mutations\n\nCes mutations suivent le même modèle d’implémentation que les autres mutations dans l’API GraphQL. Chaque mutation accepte un argument unique de type `Input`, nommé après la mutation, et retourne un type `Payload` contenant les champs spécifiés.\n\nPar exemple, il s’agit d’une mutation de `createDiscussion` de base qui crée une nouvelle discussion :\n\n```graphql\nmutation {\n  # input type: CreateDiscussionInput\n  createDiscussion(input: {repositoryId: \"1234\", categoryId: \"5678\", body: \"The body\", title: \"The title\"}) {\n\n    # response type: CreateDiscussionPayload\n    discussion {\n      id\n    }\n  }\n}\n```\n\n### createDiscussion\n\nChamps d’entrée :\n\n* `body: String!` Le corps de la nouvelle discussion.\n* `title: String!` Titre de la nouvelle discussion.\n* `repositoryId: ID!` ID d’un dépôt dans lequel créer la discussion.\n* `categoryId: ID!` ID d’un élément `DiscussionCategory` dans ce dépôt.\n* `clientMutationId: String` Identificateur unique du client effectuant la mutation.\n\nChamps de type de retour :\n\n* `clientMutationId: String` Identificateur unique fourni en tant qu’entrée.\n* `discussion: Discussion` Discussion qui a été créée.\n\n### mise à jourDiscussion\n\nChamps d’entrée :\n\n* `discussionId: ID!`L’ID du nœud de la discussion à mettre à jour.\n* `body: String` Nouveau contenu du corps de la discussion.\n* `title: String` Nouveau titre de discussion.\n* `categoryId: ID` L’ID du nœud d’un `DiscussionCategory` dans le même dépôt vers lequel transférer cette discussion.\n* `clientMutationId: String` Identificateur unique du client effectuant la mutation.\n\nChamps de type de retour :\n\n* `clientMutationId: String` Identificateur unique fourni en tant qu’entrée.\n* `discussion: Discussion` La discussion qui a été modifiée.\n\n### supprimerDiscussion\n\nChamps d’entrée :\n\n* `id: ID!` ID de nœud de la discussion à supprimer.\n* `clientMutationId: String` Identificateur unique du client effectuant la mutation.\n\nChamps de type de retour :\n\n* `clientMutationId: String` Identificateur unique fourni en tant qu’entrée.\n* `discussion: Discussion` Discussion qui a été supprimée.\n\n### ajouterCommentaireDiscussion\n\nChamps d’entrée :\n\n* `body: String!` Contenu du commentaire.\n* `discussionId: ID!` L’ID du nœud de la discussion sur laquelle commenter.\n* `replyToId: ID` ID de nœud du commentaire de discussion auquel répondre. En cas d’absence, le commentaire créé est un commentaire de niveau supérieur.\n* `clientMutationId: String` Identificateur unique du client effectuant la mutation.\n\nChamps de type de retour :\n\n* `clientMutationId: String` Identificateur unique fourni en tant qu’entrée.\n* `comment: DiscussionComment` Le commentaire de discussion qui a été créé.\n\n### updateDiscussionComment\n\nChamps d’entrée :\n\n* `body: String!` Nouveau contenu du corps du commentaire.\n* `commentId: ID!` L’ID du nœud du commentaire de discussion à mettre à jour.\n* `clientMutationId: String` Identificateur unique du client effectuant la mutation.\n\nChamps de type de retour :\n\n* `clientMutationId: String` Identificateur unique fourni en tant qu’entrée.\n* `comment: DiscussionComment` Commentaire de discussion qui a été mis à jour.\n\n### supprimerCommentaireDiscussion\n\nChamps d’entrée :\n\n* `id: ID!` L'ID de nœud du commentaire de discussion à supprimer.\n* `clientMutationId: String` Identificateur unique du client effectuant la mutation.\n\nChamps de type de retour :\n\n* `clientMutationId: String` Identificateur unique fourni en tant qu’entrée.\n* `comment: DiscussionComment` Le commentaire de discussion qui a été supprimé.\n\n### marquer le commentaire de discussion comme réponse\n\nChamps d’entrée :\n\n* `id: ID!` L’ID du nœud du commentaire de discussion à marquer comme réponse.\n* `clientMutationId: String` Identificateur unique du client effectuant la mutation.\n\nChamps de type de retour :\n\n* `clientMutationId: String` Identificateur unique fourni en tant qu’entrée.\n* `discussion: Discussion` Discussion qui inclut le commentaire choisi.\n\n### retirerLaMarqueDuCommentaireDeDiscussionCommeRéponse\n\nChamps d’entrée :\n\n* `id: ID!` L’ID du nœud du commentaire de discussion à démarquer comme réponse.\n* `clientMutationId: String` Identificateur unique du client effectuant la mutation.\n\nChamps de type de retour :\n\n* `clientMutationId: String` Identificateur unique fourni en tant qu’entrée.\n* `discussion: Discussion` Discussion qui inclut le commentaire non marqué.\n\n## Rechercher\n\nLa discussion peut être retournée à partir du champ `search` supérieur. Pour rechercher une discussion, spécifiez `type` comme `DISCUSSION`. Le type `SearchResultItemConnection` a un champ `discussionCount` pour signaler le nombre de discussions retournées, et le type `Discussion` est ajouté à l’union `SearchResultItem`. Pour plus d’informations, consultez « [Recherche](/fr/graphql/reference/search#query-searchresultitemconnection) » et « [Recherche de discussions](/fr/search-github/searching-on-github/searching-discussions) »."}