You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: x-api/activity/introduction.mdx
+10-21Lines changed: 10 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,6 +10,12 @@ The X Activity API (XAA) endpoint group allows developers to tap in to activity
10
10
11
11
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.
12
12
13
+
<Warning>
14
+
The X Activity API is available as an open beta. While in open beta, please expect potential bugs, breaking changes, or incomplete features.
15
+
16
+
Your feedback is invaluable—report issues via our [developer community forums](https://devcommunity.x.com/).
17
+
</Warning>
18
+
13
19
## Delivery Mechanisms
14
20
15
21
The X Activity API currently supports the following delivery mechanisms to send events to your app:
@@ -31,24 +37,20 @@ Profile events are triggered when a user makes changes to their profile informat
31
37
|`profile.update.profile_picture`| Fired when a user updates their profile picture |`user_id`|
32
38
|`profile.update.banner_picture`| Fired when a user updates their profile banner |`user_id`|
33
39
|`profile.update.screenname`| Fired when a user updates their display name |`user_id`|
34
-
|`profile.update.handle`| Fired when a user updates their handle |`user_id`|
35
40
|`profile.update.geo`| Fired when a user updates their profile location |`user_id`|
36
41
|`profile.update.url`| Fired when a user updates their profile website URL |`user_id`|
37
42
|`profile.update.verified_badge`| Fired when a user updates their verified badge |`user_id`|
38
43
|`profile.update.affiliate_badge`| Fired when a user updates their affiliate badge |`user_id`|
39
44
40
45
### Follow Events
41
46
42
-
Follow events are triggered when the filtered user follows another user, or is followed by another user.
47
+
Follow events are triggered when a user follows or unfollows another user.
43
48
44
49
| Event Name | Description | Filters |
45
50
| --- | --- | --- |
46
51
|`follow.follow`| Fired when a user follows another user |`user_id`|
47
52
|`follow.unfollow`| Fired when a user unfollows another user |`user_id`|
48
53
49
-
<Note>
50
-
**Enterprise Only:** The `follow.follow` and `follow.unfollow` events are only available to Enterprise and Partner tier accounts at this time.
51
-
</Note>
52
54
53
55
### Spaces Events
54
56
@@ -59,27 +61,14 @@ Spaces events are triggered when a user starts or ends a Space.
59
61
|`spaces.start`| Fired when a user starts a Space |`user_id`|
60
62
|`spaces.end`| Fired when a user ends a Space |`user_id`|
61
63
62
-
### Legacy DM Events
63
-
64
-
Legacy DM events pertain to the legacy, unencrypted DM system.
65
-
66
-
| Event Name | Description | Filters |
67
-
| --- | --- | --- |
68
-
|`dm.received`| Fired when a user receives an unencrypted direct message |`user_id`|
69
-
|`dm.sent`| Fired when a user sends an unencrypted direct message |`user_id`|
70
-
|`dm.read`| Fired when a user reads the filtered users unencrypted DM message, or "read reciept" |`user_id`|
71
-
|`dm.indicate_typing`| Fired when a user is typing a message to the filtered user |`user_id`|
72
-
73
64
### Chat Events
74
65
75
-
Chat events pertain to the new, encrypted messaging stack, or XChat.
66
+
Chat events are triggered when a user sends or receives a direct message.
76
67
77
68
| Event Name | Description | Filters |
78
69
| --- | --- | --- |
79
-
|`chat.received`| Fired when a user receives an encrypted direct message |`user_id`|
80
-
|`chat.sent`| Fired when a user sends an encrypted direct message |`user_id`|
81
-
|`chat.conversation_join`| Fired when a user joins an encrypted chat conversation |`user_id`|
82
-
70
+
|`chat.received`| Fired when a user receives a direct message |`user_id`|
71
+
|`chat.sent`| Fired when a user sends a direct message |`user_id`|
0 commit comments