GitHub Public API Limitiation Registry

[setchy]

GitHub Public API Limitations

This issue collates all of the feature gaps within the public GitHub REST API and GitHub GraphQL API

Note

See GitHub API Changelog for new feature announcements

Important

Filter issues by github-api-limitation to see full backlog

GitHub REST API - Documentation

• List Notifications endpoint /notifications
  • Filtering capabilities
    • No query parameter to filter notifications by inbox
    • No query parameter to filter notifications by saved
    • No query parameter to filter notifications by done
  • Response schema
    • No attribute in response indicating if a notification is done, saved or in the inbox.
    • Notifications of subject.type Discussion, CheckSuite, RepositoryInvitation or WorkflowRun always have null
      for subject.url and subject.latest_comment_url
  • Private repositories Notifications show in UI but not via this API
• Notification
  • No endpoint to mark notification as unread (can only mark a notification as read)
  • No endpoint to find CheckSuite of WorkflowRun information by notification_id
  • No endpoint to save/unsave a notification
• Authentication
  • No support for fine-grained tokens Add support for fine-grained personal access token auth #1492

GitHub GraphQL API - Documentation

• No query to fetch user notifications
• No query to find CheckSuite of WorkflowRun information by notification_id