Skip to content

Apply style guide: X Activity API introduction #248

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mintlify merged 1 commit into from
Jul 6, 2026
Merged

Apply style guide: X Activity API introduction #248

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions x-api/activity/introduction.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
Expand All @@ -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` |

<Note>
**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.
</Note>

### Spaces events
Expand All @@ -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

Expand All @@ -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`)
Expand Down