Merge pull request github#611 from github/update-1412620545

hubot · hubot · commit 7296b73ddc2a · 2014-10-06T13:36:01.000-05:00
diff --git a/content/changes/2014-10-06-new-attributes-for-issue-events-api.md b/content/changes/2014-10-06-new-attributes-for-issue-events-api.md
@@ -0,0 +1,19 @@
+---
+kind: change
+title: New Attributes for Issue Events API
+created_at: 2014-10-06
+author_name: jdpace
+---
+
+We've made it easier to track changes to issues. The Issue Events API now provides more context for several event types:
+
+- `assigned` and `unassigned` events now include an `assignee` object so you can see just who was assigned or unassigned.
+- `labeled` and `unlabeled` events include a `label` object.
+- `milestoned` and `demilesoned` events include a `milestone` object.
+- `renamed` events include a `rename` object with the title before and after the rename.
+
+Check out the [Issue Events API documentation][issue-events] for a full list of supported events. If you have
+any questions or feedback, please [drop us a line][contact].
+
+[issue-events]: /v3/issues/events/
+[contact]: https://github.com/contact?form[subject]=New+Attrs+for+Issue+Events+API
diff --git a/content/v3/issues/events.md b/content/v3/issues/events.md
@@ -13,6 +13,12 @@ determine who should be notified of comments.
 
 ### Attributes
 
+id
+: The Integer ID of the event.
+
+url
+: The API URL for fetching the event.
+
 actor
 : Always the User that generated the event.
 
@@ -22,6 +28,25 @@ commit_id
 event
 : Identifies the actual type of Event that occurred.
 
+created_at
+: The timestamp indicating when the event occurred.
+
+label
+: The Label object including 'name' and 'color' attributes. Only provided for 'labeled'
+  and 'unlabeled' events.
+
+assignee
+: The User object which was assigned to (or unassigned from) this Issue. Only provided for 'assigned'
+  and 'unassigned' events.
+
+milestone
+: The Milestone object including a 'title' attribute. Only provided for 'milestoned' and
+  'demilestoned' events.
+
+rename:
+: An object containing rename details including 'from' and 'to' attributes. Only
+  provided for 'renamed' events.
+
 ### Events
 
 closed
