From fa35ec74470ae5b0ed683dc135664663f17fcb54 Mon Sep 17 00:00:00 2001 From: Taylor Caldwell Date: Wed, 8 Apr 2026 11:19:36 -0700 Subject: [PATCH 1/2] Revert "Remove enterprise-only note for follow events" This reverts commit 8678a89ec9a9db80a17fd0116410bf9cf3f8d8b2. --- x-api/activity/introduction.mdx | 31 +++++++++++++++++++++---------- 1 file changed, 21 insertions(+), 10 deletions(-) diff --git a/x-api/activity/introduction.mdx b/x-api/activity/introduction.mdx index b65484b9..98dcf1f1 100644 --- a/x-api/activity/introduction.mdx +++ b/x-api/activity/introduction.mdx @@ -10,12 +10,6 @@ The X Activity API (XAA) endpoint group allows developers to tap in to activity A developer can subscribe to events they are interested in such as `profile.update.bio`, `profile.update.profile_picture` 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. - -The X Activity API is available as an open beta. While in open beta, please expect potential bugs, breaking changes, or incomplete features. - -Your feedback is invaluable—report issues via our [developer community forums](https://devcommunity.x.com/). - - ## Delivery Mechanisms The X Activity API currently supports the following delivery mechanisms to send events to your app: @@ -37,6 +31,7 @@ Profile events are triggered when a user makes changes to their profile informat | `profile.update.profile_picture` | Fired when a user updates their profile picture | `user_id` | | `profile.update.banner_picture` | Fired when a user updates their profile banner | `user_id` | | `profile.update.screenname` | Fired when a user updates their display name | `user_id` | +| `profile.update.handle` | Fired when a user updates their handle | `user_id` | | `profile.update.geo` | Fired when a user updates their profile location | `user_id` | | `profile.update.url` | Fired when a user updates their profile website URL | `user_id` | | `profile.update.verified_badge` | Fired when a user updates their verified badge | `user_id` | @@ -44,13 +39,16 @@ Profile events are triggered when a user makes changes to their profile informat ### Follow Events -Follow events are triggered when a user follows or unfollows another user. +Follow events are triggered when the filtered user follows another user, or is followed by another user. | Event Name | Description | Filters | | --- | --- | --- | | `follow.follow` | Fired when a user follows another user | `user_id` | | `follow.unfollow` | Fired when a user unfollows another user | `user_id` | + +**Enterprise Only:** The `follow.follow` and `follow.unfollow` events are only available to Enterprise and Partner tier accounts at this time. + ### Spaces Events @@ -61,14 +59,27 @@ Spaces events are triggered when a user starts or ends a Space. | `spaces.start` | Fired when a user starts a Space | `user_id` | | `spaces.end` | Fired when a user ends a Space | `user_id` | +### Legacy DM Events + +Legacy DM events pertain to the legacy, unencrypted DM system. + +| Event Name | Description | Filters | +| --- | --- | --- | +| `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 reciept" | `user_id` | +| `dm.indicate_typing` | Fired when a user is typing a message to the filtered user | `user_id` | + ### Chat Events -Chat events are triggered when a user sends or receives a direct message. +Chat events pertain to the new, encrypted messaging stack, or XChat. | Event Name | Description | Filters | | --- | --- | --- | -| `chat.received` | Fired when a user receives a direct message | `user_id` | -| `chat.sent` | Fired when a user sends a direct message | `user_id` | +| `chat.received` | Fired when a user receives an encrypted direct message | `user_id` | +| `chat.sent` | Fired when a user sends an encrypted direct message | `user_id` | +| `chat.conversation_join` | Fired when a user joins an encrypted chat conversation | `user_id` | + ### News Events From 9dee777f54dc35c468e2d276f47687870990ab76 Mon Sep 17 00:00:00 2001 From: Taylor Caldwell Date: Wed, 8 Apr 2026 11:20:59 -0700 Subject: [PATCH 2/2] Remove enterprise-only note for follow events --- x-api/activity/introduction.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/x-api/activity/introduction.mdx b/x-api/activity/introduction.mdx index 98dcf1f1..045cb83d 100644 --- a/x-api/activity/introduction.mdx +++ b/x-api/activity/introduction.mdx @@ -46,10 +46,6 @@ Follow events are triggered when the filtered user follows another user, or is f | `follow.follow` | Fired when a user follows another user | `user_id` | | `follow.unfollow` | Fired when a user unfollows another user | `user_id` | - -**Enterprise Only:** The `follow.follow` and `follow.unfollow` events are only available to Enterprise and Partner tier accounts at this time. - - ### Spaces Events Spaces events are triggered when a user starts or ends a Space.