Skip to content
forgit api docs

Get feeds

GET
/feeds

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.

API method documentation

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Response

Media type application/json
Feed

Feed

object
timeline_url
required
string
user_url
required
string
current_user_public_url
string
current_user_url
string
current_user_actor_url
string
current_user_organization_url
string
current_user_organization_urls
Array<string>
security_advisories_url
string
repository_discussions_url

A feed of discussions for a given repository.

string
repository_discussions_category_url

A feed of discussions for a given repository and category.

string
_links
required
object
timeline
required
Link With Type

Hypermedia Link with Type

object
href
required
string
type
required
string
user
required
Link With Type

Hypermedia Link with Type

object
href
required
string
type
required
string
security_advisories
Link With Type

Hypermedia Link with Type

object
href
required
string
type
required
string
current_user
Link With Type

Hypermedia Link with Type

object
href
required
string
type
required
string
current_user_public
Link With Type

Hypermedia Link with Type

object
href
required
string
type
required
string
current_user_actor
Link With Type

Hypermedia Link with Type

object
href
required
string
type
required
string
current_user_organization
Link With Type

Hypermedia Link with Type

object
href
required
string
type
required
string
current_user_organizations
Array<object>
Link With Type

Hypermedia Link with Type

object
href
required
string
type
required
string
repository_discussions
Link With Type

Hypermedia Link with Type

object
href
required
string
type
required
string
repository_discussions_category
Link With Type

Hypermedia Link with Type

object
href
required
string
type
required
string
Examples
Example default 
{
  "timeline_url": "https://github.com/timeline",
  "user_url": "https://github.com/{user}",
  "current_user_public_url": "https://github.com/octocat",
  "current_user_url": "https://github.com/octocat.private?token=abc123",
  "current_user_actor_url": "https://github.com/octocat.private.actor?token=abc123",
  "current_user_organization_url": "",
  "current_user_organization_urls": [
    "https://github.com/organizations/github/octocat.private.atom?token=abc123"
  ],
  "security_advisories_url": "https://github.com/security-advisories",
  "_links": {
    "timeline": {
      "href": "https://github.com/timeline",
      "type": "application/atom+xml"
    },
    "user": {
      "href": "https://github.com/{user}",
      "type": "application/atom+xml"
    },
    "current_user_public": {
      "href": "https://github.com/octocat",
      "type": "application/atom+xml"
    },
    "current_user": {
      "href": "https://github.com/octocat.private?token=abc123",
      "type": "application/atom+xml"
    },
    "current_user_actor": {
      "href": "https://github.com/octocat.private.actor?token=abc123",
      "type": "application/atom+xml"
    },
    "current_user_organization": {
      "href": "",
      "type": ""
    },
    "current_user_organizations": [
      {
        "href": "https://github.com/organizations/github/octocat.private.atom?token=abc123",
        "type": "application/atom+xml"
      }
    ],
    "security_advisories": {
      "href": "https://github.com/security-advisories",
      "type": "application/atom+xml"
    }
  }
}