GitHub

GitHub Activity API

The Activity API from GitHub — 25 operation(s) for activity.

GitHub OpenAPI

Operations 31

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /events List recent public events across the server · GitHub List Public Events #
Ask an LLM
“What public activity is happening across the whole GitHub instance right now?”
“Can I see a global stream of recent public events from every user and repo?”
Tell an agent
List the latest public events across the entire server.
Show me the global public activity stream.
GET /feeds List the Atom feeds available to me · GitHub Get Feeds #
Ask an LLM
“Which Atom timeline feeds can I subscribe to as the signed-in user?”
“Where do I find the URL of my private activity feed for a feed reader?”
Tell an agent
List the Atom feed URLs available to my account.
Get my timeline feed links for a feed reader.
GET /networks/{owner}/{repo}/events List public events for a repository's fork network · GitHub List Public Events for a Network of Repositories #
Ask an LLM
“What public activity is happening across a repository and all of its forks?”
“Can I see events from the whole fork network of a project, not just the main repo?”
Tell an agent
List public events across the fork network of {owner}/{repo}.
Show activity from {repo} by {owner} and every fork of it.
GET /notifications List my notifications · GitHub List Notifications for the Authenticated User #
Ask an LLM
“What unread notifications do I have across all my repositories?”
“Can I list only notifications for threads where I'm directly participating or mentioned?”
Tell an agent
List my unread notifications from every repository.
Show my notifications updated after {since}.
PUT /notifications Mark all my notifications as read · GitHub Mark Notifications as Read #
Ask an LLM
“How do I clear every notification in my inbox at once?”
“Can I mark notifications read only up to a certain time, leaving newer ones unread?”
Tell an agent
Mark all my notifications across every repository as read.
Mark my notifications as read up to {last_read_at}.
GET /notifications/threads/{thread_id} Get one notification thread · GitHub Get a Thread #
Ask an LLM
“What is a particular notification thread about and why did I get it?”
“Can I look up the details of one notification by its thread ID?”
Tell an agent
Show notification thread {thread_id}.
Get the subject and reason for notification {thread_id}.
PATCH /notifications/threads/{thread_id} Mark one notification thread as read · GitHub Mark a Thread as Read #
Ask an LLM
“Can I mark just a single notification as read without clearing the rest?”
“Is there a way to dismiss one notification thread as read?”
Tell an agent
Mark notification thread {thread_id} as read.
Dismiss thread {thread_id} as read, leaving my other notifications alone.
GET /notifications/threads/{thread_id}/subscription Check my subscription to a notification thread · GitHub Get a Thread Subscription for the Authenticated User #
Ask an LLM
“Am I subscribed to a given notification thread, or have I ignored it?”
“Why do I keep getting updates on this thread — am I subscribed?”
Tell an agent
Check my subscription status for thread {thread_id}.
Tell me whether I'm ignoring notification thread {thread_id}.
PUT /notifications/threads/{thread_id}/subscription Subscribe to or ignore a notification thread · GitHub Set a Thread Subscription #
Ask an LLM
“Can I mute a noisy thread until someone mentions me again?”
“How do I start getting notifications on a thread I'm not currently following?”
Tell an agent
Ignore future notifications on thread {thread_id} by setting ignored to {ignored}.
Subscribe me to notification thread {thread_id}.
DELETE /notifications/threads/{thread_id}/subscription Unsubscribe from a notification thread · GitHub Delete a Thread Subscription #
Ask an LLM
“How do I stop following a thread entirely rather than just muting it?”
“Can I remove my subscription to one conversation so it reverts to my repo watch setting?”
Tell an agent destructive · confirm first
Delete my subscription to thread {thread_id}.
Unsubscribe me completely from notification thread {thread_id}.
GET /orgs/{org}/events List an organization's public events · GitHub List Public Organization Events #
Ask an LLM
“What public activity has an organization had recently?”
“Can I see the public event feed for a company's GitHub org?”
Tell an agent
List public events for organization {org}.
Show the recent public activity of {org}.
GET /repos/{owner}/{repo}/events List events for a single repository · GitHub List Repository Events #
Ask an LLM
“What has happened recently in one repository, like pushes, issues and pull requests?”
“Can I get the activity feed of a single repo without its forks?”
Tell an agent
List recent events for repository {owner}/{repo}.
Show the activity feed of {repo} owned by {owner}, excluding forks.
GET /repos/{owner}/{repo}/notifications List my notifications for one repository · GitHub List Repository Notifications for the Authenticated User #
Ask an LLM
“What notifications do I have for just one repository?”
“Can I see only the notifications from a single repo where I'm participating?”
Tell an agent
List my notifications for {owner}/{repo}.
Show my notifications in {owner}/{repo} since {since}.
PUT /repos/{owner}/{repo}/notifications Mark all notifications in one repository as read · GitHub Mark Repository Notifications as Read #
Ask an LLM
“Can I clear every notification from one repo without touching my other repos?”
“Is it possible to mark a repository's notifications read only up to a set time?”
Tell an agent
Mark all my notifications in {owner}/{repo} as read.
Mark repo {owner}/{repo} notifications read up to {last_read_at}.
GET /repos/{owner}/{repo}/stargazers List who starred a repository · GitHub List Stargazers #
Ask an LLM
“Who has starred a particular repository?”
“Can I get the list of stargazers for a project?”
Tell an agent
List the stargazers of {owner}/{repo}.
Show everyone who starred {repo} by {owner}.
GET /repos/{owner}/{repo}/subscribers List who watches a repository · GitHub List Watchers #
Ask an LLM
“Which users are watching a repository for notifications?”
“Who is subscribed to updates from a given repo?”
Tell an agent
List the watchers of {owner}/{repo}.
Show the users subscribed to notifications for {repo} owned by {owner}.
GET /repos/{owner}/{repo}/subscription Check whether I'm watching a repository · GitHub Get a Repository Subscription #
Ask an LLM
“Am I watching a given repository, or have I set it to ignore?”
“What's my notification setting on this repo?”
Tell an agent
Check my watch subscription for {owner}/{repo}.
Tell me if I'm ignoring notifications from {owner}/{repo}.
PUT /repos/{owner}/{repo}/subscription Watch or ignore a repository · GitHub Set a Repository Subscription #
Ask an LLM
“How do I start watching a repository so I get all its notifications?”
“Can I block every notification from a noisy repo without unwatching it?”
Tell an agent
Watch {owner}/{repo} by setting subscribed to {subscribed}.
Ignore all notifications from {owner}/{repo} with ignored set to {ignored}.
DELETE /repos/{owner}/{repo}/subscription Stop watching a repository · GitHub Delete a Repository Subscription #
Ask an LLM
“What's the way to stop watching a repository completely?”
“Can I delete my watch subscription on a repo instead of just ignoring it?”
Tell an agent destructive · confirm first
Stop watching {owner}/{repo}.
Remove my repository subscription for {repo} owned by {owner}.
GET /user/starred List the repositories I've starred · GitHub List Repositories Starred by the Authenticated User #
Ask an LLM
“Which repositories have I starred?”
“Can I sort my starred repos by when I starred them?”
Tell an agent
List the repositories I've starred.
Show my starred repos sorted by {sort} in {direction} order.
GET /user/starred/{owner}/{repo} Check whether I've starred a repository · GitHub Check if a Repository is Starred by the Authenticated User #
Ask an LLM
“Have I already starred a particular repository?”
“Is this repo in my stars?”
Tell an agent
Check whether I've starred {owner}/{repo}.
Confirm {repo} by {owner} is in my stars.
PUT /user/starred/{owner}/{repo} Star a repository · GitHub Star a Repository for the Authenticated User #
Ask an LLM
“Can I star a repository through the API?”
“How do I bookmark a project by starring it?”
Tell an agent
Star {owner}/{repo}.
Add {repo} from {owner} to my starred repositories.
DELETE /user/starred/{owner}/{repo} Unstar a repository · GitHub Unstar a Repository for the Authenticated User #
Ask an LLM
“How can I remove a star I gave to a repository?”
“Can I unstar a project I no longer follow?”
Tell an agent destructive · confirm first
Unstar {owner}/{repo}.
Remove {repo} from {owner} from my starred list.
GET /user/subscriptions List the repositories I'm watching · GitHub List Repositories Watched by the Authenticated User #
Ask an LLM
“Which repositories am I currently watching?”
“What repos am I subscribed to for notifications?”
Tell an agent
List the repositories I'm watching.
Show every repo my account is subscribed to.
GET /users/{username}/events List events performed by a user, private included · GitHub List Events for the Authenticated User #
Ask an LLM
“What has a user been doing lately, including private events if I'm signed in as them?”
“Can I see my own full activity history, not just the public part?”
Tell an agent
List the events performed by {username}, including private ones if I'm that user.
Show my own recent activity as {username}.
GET /users/{username}/events/orgs/{org} List my private organization dashboard events · GitHub List Organization Events for the Authenticated User #
Ask an LLM
“What does my organization dashboard feed show, including private activity?”
“Can I see private events inside an org I belong to?”
Tell an agent
List the organization dashboard events for {username} in {org}.
Show private activity from {org} as seen by {username}.
GET /users/{username}/events/public List a user's public events only · GitHub List Public Events for a User #
Ask an LLM
“What public activity has a specific GitHub user had?”
“Can I see only the public events someone performed, never their private ones?”
Tell an agent
List only the public events performed by {username}.
Show the public activity feed of user {username}.
GET /users/{username}/received_events List events a user received from follows and watches · GitHub List Events Received by the Authenticated User #
Ask an LLM
“What events show up in a user's feed from the people they follow and repos they watch?”
“Can I see my received events, private ones included?”
Tell an agent
List the events {username} received from followed users and watched repos.
Show the incoming activity feed for {username}, including private events.
GET /users/{username}/received_events/public List public events a user received · GitHub List Public Events Received by a User #
Ask an LLM
“Which public events landed in a user's feed from the accounts and repos they follow?”
“Can I view someone's received feed restricted to public events?”
Tell an agent
List only the public events received by {username}.
Show the public part of the feed {username} receives.
GET /users/{username}/starred List repositories another user has starred · GitHub List Repositories Starred by a User #
Ask an LLM
“Which repositories has a specific GitHub user starred?”
“Can I sort another person's stars by most recently starred?”
Tell an agent
List the repositories {username} has starred.
Show repos starred by {username}, sorted by {sort}.
GET /users/{username}/subscriptions List repositories another user is watching · GitHub List Repositories Watched by a User #
Ask an LLM
“What repositories is a given user watching?”
“Which repos does someone else follow for notifications?”
Tell an agent
List the repositories {username} is watching.
Show the repos {username} subscribes to.

Documentation

📖
Documentation
https://docs.github.com/en/rest/apps
📖
Documentation
https://docs.github.com/en/rest/codes-of-conduct/codes-of-conduct
📖
Documentation
https://docs.github.com/en/rest/emojis
📖
Documentation
https://docs.github.com/en/rest/gitignore
📖
Documentation
https://docs.github.com/en/rest/apps/installations
📖
Documentation
https://docs.github.com/en/rest/enterprise-admin
📖
Documentation
https://docs.github.com/en/rest/activity/events
📖
Documentation
https://docs.github.com/en/rest/orgs
📖
Documentation
https://docs.github.com/en/rest/rate-limit
📖
Documentation
https://docs.github.com/en/enterprise-cloud@latest/rest/scim
📖
Documentation
https://docs.github.com/en/rest/using-the-rest-api/getting-started-with-the-rest-api
📖
Documentation
https://docs.github.com/en/rest/teams
📖
Documentation
https://docs.github.com/en/rest/meta/meta
📖
Documentation
https://docs.github.com/en/rest/actions
📖
Documentation
https://docs.github.com/en/rest/branches
📖
Documentation
https://docs.github.com/en/rest/code-scanning
📖
Documentation
https://docs.github.com/en/rest/collaborators
📖
Documentation
https://docs.github.com/en/rest/dependabot
📖
Documentation
https://docs.github.com/en/rest/webhooks
📖
Documentation
https://docs.github.com/en/rest/pulls
📖
Documentation
https://docs.github.com/en/rest/git/tags
📖
Documentation
https://docs.github.com/en/rest/repos/autolinks
📖
Documentation
https://docs.github.com/en/rest/collaborators/invitations

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/openapi/github-activity-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/asyncapi/github-webhooks-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/json-schema/github-repository-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/json-schema/github-minimal-repository-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/json-schema/github-simple-user-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/json-schema/github-feed-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/json-schema/github-event-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/json-schema/github-thread-schema.json

Other Resources

🔗
Reference
https://docs.github.com/en/webhooks/webhook-events-and-payloads

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/github-activity-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

github-activity-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.1.4
  title: GitHub v3 REST Activity API
  description: GitHub's v3 REST API.
  license:
    name: MIT
    url: https://spdx.org/licenses/MIT
  termsOfService: https://docs.github.com/articles/github-terms-of-service
  contact:
    name: Support
    url: https://support.github.com/contact?tags=dotcom-rest-api
  x-github-plan: ghes
  x-github-release: 3.9
servers:
- url: '{protocol}://{hostname}/api/v3'
  variables:
    hostname:
      description: Self-hosted Enterprise Server hostname
      default: HOSTNAME
    protocol:
      description: Self-hosted Enterprise Server protocol
      default: http
tags:


# --- truncated at 32 KB (162 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/openapi/github-activity-api-openapi.yml