Skip to main content

feeds

Creates, updates, deletes, gets or lists a feeds resource.

Overview​

Namefeeds
TypeResource
Idgithub.activity.feeds

Fields​

The following fields are returned by SELECT queries:

Response

NameDatatypeDescription
_linksobject
current_user_actor_urlstring (example: https://github.com/octocat.private.actor?token=abc123)
current_user_organization_urlstring (example: https://github.com/octocat-org)
current_user_organization_urlsarray
current_user_public_urlstring (example: https://github.com/octocat)
current_user_urlstring (example: https://github.com/octocat.private?token=abc123)
repository_discussions_category_urlstringA feed of discussions for a given repository and category. (example: https://github.com/{user}/{repo}/discussions/categories/{category})
repository_discussions_urlstringA feed of discussions for a given repository. (example: https://github.com/{user}/{repo}/discussions)
security_advisories_urlstring (example: https://github.com/security-advisories)
timeline_urlstring (example: https://github.com/timeline)
user_urlstring (example: https://github.com/{user})

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_feedsselectLists the feeds available to the authenticated user. The response provides a URL for each feed. You can then get a specific feed by sending a request to one of the feed URLs.

* Timeline: The GitHub global public timeline
* User: The public timeline for any user, using uri_template. For more information, see "Hypermedia."
* Current user public: The public timeline for the authenticated user
* Current user: The private timeline for the authenticated user
* Current user actor: The private timeline for activity created by the authenticated user
* Current user organizations: The private timeline for the organizations the authenticated user is a member of.
* Security advisories: A collection of public announcements that provide information about security-related vulnerabilities in software on GitHub.

By default, timeline resources are returned in JSON. You can specify the application/atom+xml type in the Accept header to return timeline resources in Atom format. For more information, see "Media types."

> [!NOTE]
> Private feeds are only returned when authenticating via Basic Auth since current feed URIs use the older, non revocable auth tokens.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription

SELECT examples​

Lists the feeds available to the authenticated user. The response provides a URL for each feed. You can then get a specific feed by sending a request to one of the feed URLs.

* Timeline: The GitHub global public timeline
* User: The public timeline for any user, using uri_template. For more information, see "Hypermedia."
* Current user public: The public timeline for the authenticated user
* Current user: The private timeline for the authenticated user
* Current user actor: The private timeline for activity created by the authenticated user
* Current user organizations: The private timeline for the organizations the authenticated user is a member of.
* Security advisories: A collection of public announcements that provide information about security-related vulnerabilities in software on GitHub.

By default, timeline resources are returned in JSON. You can specify the application/atom+xml type in the Accept header to return timeline resources in Atom format. For more information, see "Media types."

> [!NOTE]
> Private feeds are only returned when authenticating via Basic Auth since current feed URIs use the older, non revocable auth tokens.

SELECT
_links,
current_user_actor_url,
current_user_organization_url,
current_user_organization_urls,
current_user_public_url,
current_user_url,
repository_discussions_category_url,
repository_discussions_url,
security_advisories_url,
timeline_url,
user_url
FROM github.activity.feeds
;