List discussions
The List Discussions tool provides an efficient way to retrieve and manage discussions within GitHub repositories or organizations. It supports pagination, filtering, and sorting to help developers stay on top of important conversations.
Features
- Retrieve discussions from specific GitHub repositories or entire organizations.
- Filter discussions by category ID to focus on relevant topics.
- Supports customizable ordering by creation or update date in ascending or descending order.
- Pagination support with cursors to handle large sets of discussions efficiently.
- Adjustable number of results per page, ranging from 1 to 100, to optimize data retrieval.
Benefits
- Enhances visibility into project discussions, facilitating better team collaboration.
- Saves time by allowing targeted retrieval of relevant discussions through filtering and sorting.
- Supports scalable data handling with pagination for repositories with extensive discussion histories.
- Improves project management by keeping track of the latest discussions and updates.
- Provides integration-ready data fetching capabilities for automating workflows and analytics.
Description
List discussions for a repository or organisation.
Parameters
7 parameters
| Name | Type | Description |
|---|---|---|
| after | string | Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs. |
| category | string | Optional filter by discussion category ID. If provided, only discussions with this category are listed. |
| direction | enum | Order direction. |
| orderBy | enum | Order discussions by field. If provided, the 'direction' also needs to be provided. |
| ownerrequired | string | Repository owner |
| perPage | number | Results per page for pagination (min 1, max 100) |
| repo | string | Repository name. If not provided, discussions will be queried at the organisation level. |