diff --git a/x-api/activity/introduction.mdx b/x-api/activity/introduction.mdx index 41511a78c..6fccf9358 100644 --- a/x-api/activity/introduction.mdx +++ b/x-api/activity/introduction.mdx @@ -9,7 +9,7 @@ import { Button } from '/snippets/button.mdx'; The X Activity API (XAA) endpoint group allows developers to tap into activity events happening on the X Platform. -A developer can subscribe to events they are interested in such as `profile.update.bio`, `post.create`, `post.delete` etc. and filter for the User ID whose events they want. The matching events for that User ID will be delivered to your app with sub-second latency. +You can subscribe to events you are interested in, such as `profile.update.bio`, `post.create`, or `post.delete`, and filter by the User ID whose events you want. XAA delivers matching events for that User ID to your app with sub-second latency. ## Delivery mechanisms @@ -95,7 +95,7 @@ Legacy DM events pertain to the legacy, unencrypted DM system. | --- | --- | --- | | `dm.received` | Fired when a user receives an unencrypted direct message | `user_id` | | `dm.sent` | Fired when a user sends an unencrypted direct message | `user_id` | -| `dm.read` | Fired when a user reads the filtered users unencrypted DM message, or "read receipt" | `user_id` | +| `dm.read` | Fired when a user reads the filtered user's unencrypted DM message, or "read receipt" | `user_id` | | `dm.indicate_typing` | Fired when a user is typing a message to the filtered user | `user_id` | ### News events @@ -107,7 +107,7 @@ News events provide updates on trending topics and headlines curated by Grok. | `news.new` | New grok-curated trends and headlines | `keyword` | -**Enterprise Only:** The `news.new` event is only available to Enterprise and Partner tier accounts at this time. +**Enterprise only:** The `news.new` event is only available to Enterprise and Partner tier accounts at this time. ### Spaces events @@ -123,7 +123,7 @@ In future releases, XAA will expand to support additional event types including ## Event privacy and authentication -The X Activity API distinguishes between **public events** and **private events** as at parity with the X app as explained below. +The X Activity API distinguishes between **public events** and **private events**, at parity with the X app, as explained below. ### Public events @@ -137,7 +137,7 @@ For these public events, you can create subscriptions by specifying the user ID ### Private events -Private events are activities that require explicit user consent through OAuth authentication. A User has to authenticate via X and give explicit permission to a developer app to access these events. +Private events are activities that require explicit user consent through OAuth authentication. A user must authenticate via X and grant explicit permission to a developer app to access these events. **Current private events:** - Likes (`like.create`)