For the Issues Events API and Timeline API, learn about each event type, the triggering action on GitHub, and each event's unique properties.
Issue events are triggered by activity in issues and pull requests and are available in the Issue Events API and the Timeline Events API. Each event type specifies whether the event is available in the Issue Events or Timeline Events APIs.
GitHub's REST API considers every pull request to be an issue, but not every issue is a pull request. For this reason, the Issue Events and Timeline Events endpoints may return both issues and pull requests in the response. Pull requests have a pull_request property in the issue object. Because pull requests are issues, issue and pull request numbers do not overlap in a repository. For example, if you open your first issue in a repository, the number will be 1. If you then open a pull request, the number will be 2. Each event type specifies if the event occurs in pull request, issues, or both.
Issue event object common properties
Issue events all have the same object structure, except events that are only available in the Timeline Events API. Some events also include additional properties that provide more context about the event resources. Refer to the specific event to for details about any properties that differ from this object format.
Identifies the actual type of event that occurred.
commit_id
string
The SHA of the commit that referenced this issue.
commit_url
string
The GitHub REST API link to the commit that referenced this issue.
created_at
string
The timestamp indicating when the event occurred.
added_to_project
The issue or pull request was added to a project board. You only see this event in responses when project boards have been enabled in the repository.
Availability
Issue type
Issue events API
Timeline events API
Issues
Pull request
X
X
Event object properties
Note: Project card details are now shown in REST API responses for project-related issue and timeline events. This feature is now available for developers to preview. For details, see the blog post.
To receive the project_card attribute, project boards must be enabled for a repository, and you must provide a custom media type in the Accept header:
application/vnd.github.starfox-preview+json
Warning: The API may change without advance notice during the preview period. Preview features are not supported for production use. If you experience any issues, contact your site administrator.
Identifies the actual type of event that occurred.
commit_id
string
The SHA of the commit that referenced this issue.
commit_url
string
The GitHub REST API link to the commit that referenced this issue.
created_at
string
The timestamp indicating when the event occurred.
closed
The issue or pull request was closed. When the commit_id is present, it identifies the commit that closed the issue using "closes / fixes" syntax. For more information about the syntax, see "Linking a pull request to an issue".
Identifies the actual type of event that occurred.
commit_id
string
The SHA of the commit that referenced this issue.
commit_url
string
The GitHub REST API link to the commit that referenced this issue.
created_at
string
The timestamp indicating when the event occurred.
commented
A comment was added to the issue or pull request.
Availability
Issue type
Issue events API
Timeline events API
Issues
Pull requests
X
Event object properties
This events properties do not use the same structure as the issue event object common properties. The following properties are returned for this event.
The timestamp indicating when the comment was added.
updated_at
string
The timestamp indicating when the comment was updated or created, if the comment is never updated.
author_association
string
The permissions the user has in the issue's repository. For example, the value would be "OWNER" if the owner of repository created a comment.
body
string
The comment body text.
event
string
The event value is "commented".
actor
object
The person who generated the event.
committed
A commit was added to the pull request's HEAD branch.
Availability
Issue type
Issue events API
Timeline events API
Pull requests
X
Event object properties
This events properties do not use the same structure as the issue event object common properties. The following properties are returned for this event.