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: enterprise-api/account-activity/introduction.mdx
+16-16Lines changed: 16 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,7 +32,7 @@ This API is commonly used to build applications that need to react instantly to
32
32
33
33
## How it works
34
34
35
-
1.**Register webhook** — Register your webhook URL via the [V2 Webhooks API](/enterprise-api/webhooks/introduction)
35
+
1.**Register webhook** — Register your webhook URL via the [V2 Webhooks API](/x-api/webhooks/introduction)
36
36
2.**Subscribe users** — Add user subscriptions to your webhook
37
37
3.**Receive events** — Get activity events delivered as POST requests with JSON payloads
38
38
4.**Process events** — Handle events in your application and respond with `200 OK`
@@ -64,9 +64,9 @@ You will receive all related activities below for each user subscription on your
64
64
-**Subscription revokes** (by user)
65
65
66
66
<Note>
67
-
We do not deliver home timeline data via the Account Activity API. Use the [User Posts timeline by User ID](/enterprise-api/posts/timelines/get-user-tweets) endpoint to pull this data.
67
+
We do not deliver home timeline data via the Account Activity API. Use the [User Posts timeline by User ID](/x-api/posts/timelines/get-user-tweets) endpoint to pull this data.
68
68
69
-
The returned Posts from the Account Activity API count towards the monthly [Post cap](/enterprise-api/fundamentals/post-cap).
69
+
The returned Posts from the Account Activity API count towards the monthly [Post cap](/x-api/fundamentals/post-cap).
70
70
</Note>
71
71
72
72
---
@@ -544,11 +544,11 @@ This ensures that applications can process the entire content of longform posts,
544
544
</Accordion>
545
545
546
546
<Accordiontitle="I need development, staging, and production environments. Is this possible?">
547
-
Yes! You can register multiple webhook URLs and manage subscriptions separately via the [V2 Webhooks API](/enterprise-api/webhooks/introduction).
547
+
Yes! You can register multiple webhook URLs and manage subscriptions separately via the [V2 Webhooks API](/x-api/webhooks/introduction).
548
548
</Accordion>
549
549
550
550
<Accordiontitle="Do you have any step-by-step guides for getting set up?">
551
-
Yes! See the [Account Activity API Quickstart](/enterprise-api/account-activity/quickstart), the [Getting Started with Webhooks guide](/enterprise-api/webhooks/quickstart), and the [Account Activity API Sample Application](https://github.com/xdevplatform/account-activity-dashboard-enterprise/tree/master).
551
+
Yes! See the [Account Activity API Quickstart](/x-api/account-activity/quickstart), the [Getting Started with Webhooks guide](/x-api/webhooks/quickstart), and the [Account Activity API Sample Application](https://github.com/xdevplatform/account-activity-dashboard-enterprise/tree/master).
552
552
</Accordion>
553
553
554
554
<Accordiontitle="What authentication do I need for the Account Activity API?">
@@ -579,14 +579,14 @@ This ensures that applications can process the entire content of longform posts,
579
579
580
580
| Purpose | V2 Endpoint |
581
581
|:--------|:------------|
582
-
| Subscribes an application to an account's events |[`POST /2/account_activity/webhooks/:webhook_id/subscriptions/all`](/enterprise-api/account-activity/create-subscription)|
583
-
| Returns a count of currently active subscriptions |[`GET /2/account_activity/subscriptions/count`](/enterprise-api/account-activity/get-subscription-count)|
584
-
| Checks if a webhook is subscribed to an account |[`GET /2/account_activity/webhooks/:webhook_id/subscriptions/all`](/enterprise-api/account-activity/validate-subscription)|
585
-
| Returns a list of currently active subscriptions |[`GET /2/account_activity/webhooks/:webhook_id/subscriptions/all/list`](/enterprise-api/account-activity/get-subscriptions)|
586
-
| Deactivates a subscription using app-only OAuth |[`DELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/all`](/enterprise-api/account-activity/delete-subscription)|
587
-
| Creates a replay job |[`POST /2/account_activity/replay/webhooks/:webhook_id/subscriptions/all`](/enterprise-api/account-activity/create-replay-job)|
582
+
| Subscribes an application to an account's events |[`POST /2/account_activity/webhooks/:webhook_id/subscriptions/all`](/x-api/account-activity/create-subscription)|
583
+
| Returns a count of currently active subscriptions |[`GET /2/account_activity/subscriptions/count`](/x-api/account-activity/get-subscription-count)|
584
+
| Checks if a webhook is subscribed to an account |[`GET /2/account_activity/webhooks/:webhook_id/subscriptions/all`](/x-api/account-activity/validate-subscription)|
585
+
| Returns a list of currently active subscriptions |[`GET /2/account_activity/webhooks/:webhook_id/subscriptions/all/list`](/x-api/account-activity/get-subscriptions)|
586
+
| Deactivates a subscription using app-only OAuth |[`DELETE /2/account_activity/webhooks/:webhook_id/subscriptions/:user_id/all`](/x-api/account-activity/delete-subscription)|
587
+
| Creates a replay job |[`POST /2/account_activity/replay/webhooks/:webhook_id/subscriptions/all`](/x-api/account-activity/create-replay-job)|
588
588
589
-
For webhook management endpoints (register, view, validate, delete), see the [V2 Webhooks API documentation](/enterprise-api/webhooks/introduction).
589
+
For webhook management endpoints (register, view, validate, delete), see the [V2 Webhooks API documentation](/x-api/webhooks/introduction).
590
590
591
591
---
592
592
@@ -602,16 +602,16 @@ For webhook management endpoints (register, view, validate, delete), see the [V2
| POST /1.1/account\_activity/webhooks.json?url=\<URL\>| POST /2/webhooks |[Docs](https://docs.x.com/enterprise-api/webhooks/introduction). Requires OAuth2AppOnly. |
21
-
| GET /1.1/account\_activity/webhooks.json | GET /2/webhooks |[Docs](https://docs.x.com/enterprise-api/webhooks/introduction). Requires OAuth2AppOnly. |
22
-
| PUT /1.1/account\_activity/webhooks/:webhook\_id.json | PUT /2/webhooks/:webhook\_id | Triggers CRC. [Docs](https://docs.x.com/enterprise-api/webhooks/introduction). Requires OAuth2AppOnly. |
| POST /1.1/account\_activity/webhooks.json?url=\<URL\>| POST /2/webhooks |[Docs](https://docs.x.com/x-api/webhooks/introduction). Requires OAuth2AppOnly. |
21
+
| GET /1.1/account\_activity/webhooks.json | GET /2/webhooks |[Docs](https://docs.x.com/x-api/webhooks/introduction). Requires OAuth2AppOnly. |
22
+
| PUT /1.1/account\_activity/webhooks/:webhook\_id.json | PUT /2/webhooks/:webhook\_id | Triggers CRC. [Docs](https://docs.x.com/x-api/webhooks/introduction). Requires OAuth2AppOnly. |
| POST /1.1/account\_activity/webhooks/:webhook\_id/subscriptions/all.json | POST /2/account\_activity/webhooks/:webhook\_id/subscriptions/all | Requires OAuthUser. |
25
25
| GET /1.1/account\_activity/subscriptions/count.json | GET /2/account\_activity/subscriptions/count | Requires OAuth2AppOnly. |
26
26
| GET /1.1/account\_activity/webhooks/:webhook\_id/subscriptions/all.json | GET /2/account\_activity/webhooks/:webhook\_id/subscriptions/all | Requires OAuthUser. |
@@ -30,7 +30,7 @@ This guide helps you migrate from the legacy Enterprise Account Activity API to
30
30
31
31
***Response Formats**: Review the success and error response structures in the AAAPI documentation.
32
32
33
-
When migrating, update your code to use the new base paths, adjust authentication flows, and manage webhooks using the [V2 Webhooks API](https://docs.x.com/enterprise-api/webhooks/introduction).
33
+
When migrating, update your code to use the new base paths, adjust authentication flows, and manage webhooks using the [V2 Webhooks API](https://docs.x.com/x-api/webhooks/introduction).
34
34
35
35
### How to Migrate
36
36
@@ -49,7 +49,7 @@ When migrating, update your code to use the new base paths, adjust authenticatio
49
49
* Client ID and Client Secret.
50
50
***Verify or Reconfigure Your Webhook**:
51
51
* Use your existing webhook URL or set up a new one (e.g., https://your\_domain.com/webhook/twitter).
52
-
* Follow the [V2 Webhooks API documentation](https://docs.x.com/enterprise-api/webhooks/introduction) to register and manage your webhook.
52
+
* Follow the [V2 Webhooks API documentation](https://docs.x.com/x-api/webhooks/introduction) to register and manage your webhook.
Copy file name to clipboardExpand all lines: enterprise-api/account-activity/quickstart.mdx
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ The Account Activity API is available on the Enterprise and Pay Per Use tiers. S
27
27
28
28
## 3. Register a webhook
29
29
30
-
To receive Account Activity events, you must register a webhook with a publicly accessible HTTPS URL. See the [V2 Webhooks API documentation](/enterprise-api/webhooks/introduction) for details on developing a webhook consumer app, registering a webhook, securing it, and handling Challenge-Response Checks (CRC).
30
+
To receive Account Activity events, you must register a webhook with a publicly accessible HTTPS URL. See the [V2 Webhooks API documentation](/x-api/webhooks/introduction) for details on developing a webhook consumer app, registering a webhook, securing it, and handling Challenge-Response Checks (CRC).
31
31
32
32
- Ensure your webhook is configured to handle POST requests with JSON-encoded event payloads.
33
33
- Obtain the **`webhook_id`** from the webhook registration response, as it is required for managing subscriptions.
@@ -62,7 +62,7 @@ Once you have a registered webhook with a valid `webhook_id`, you can manage use
Returns the total count of active subscriptions and the provisioned limit for the authenticating application.
222
222
@@ -251,7 +251,7 @@ DM-only subscriptions are no longer supported. The `subscriptions_count_direct_m
251
251
252
252
AAAv2 provides replay functionality that allows you to retrieve past events for a specified time range and re-deliver them to your webhook. This is useful for recovering missed events due to downtime.
Copy file name to clipboardExpand all lines: enterprise-api/activity/introduction.mdx
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ A developer can subscribe to events they are interested in such as `profile.upda
15
15
The X Activity API currently supports the following delivery mechanisms to send events to your app:
16
16
17
17
- Persistent HTTP stream
18
-
-[Webhook](/enterprise-api/webhooks/introduction)
18
+
-[Webhook](/x-api/webhooks/introduction)
19
19
20
20
## Supported Event Types
21
21
@@ -96,7 +96,7 @@ News events provide updates on trending topics and headlines curated by Grok.
96
96
In future releases, XAA will expand to support additional event types including social interactions, content engagement, monetization features, and more. We will continue to update our docs when new event types become available.
97
97
98
98
<Note>
99
-
**Note:** XAA does not deliver posts. For real-time post delivery, see our [Filtered Stream](/enterprise-api/posts/filtered-stream/introduction) endpoint, which allows developers to filter for and stream posts in real-time.
99
+
**Note:** XAA does not deliver posts. For real-time post delivery, see our [Filtered Stream](/x-api/posts/filtered-stream/introduction) endpoint, which allows developers to filter for and stream posts in real-time.
100
100
</Note>
101
101
102
102
## Event Privacy and Authentication
@@ -136,11 +136,11 @@ The X Activity API has different subscription limits based on your account tier:
136
136
137
137
| Method | Endpoint | Description |
138
138
|:-------|:---------|:------------|
139
-
| GET |[`/2/activity/stream`](/enterprise-api/activity/activity-stream)| Connect to activity stream |
140
-
| POST |[`/2/activity/subscriptions`](/enterprise-api/activity/create-x-activity-subscription)| Create a subscription |
141
-
| GET |[`/2/activity/subscriptions`](/enterprise-api/activity/get-x-activity-subscriptions)| List subscriptions |
142
-
| PUT |[`/2/activity/subscriptions/:id`](/enterprise-api/activity/update-x-activity-subscription)| Update a subscription |
143
-
| DELETE |[`/2/activity/subscriptions/:id`](/enterprise-api/activity/deletes-x-activity-subscription)| Delete a subscription |
139
+
| GET |[`/2/activity/stream`](/x-api/activity/activity-stream)| Connect to activity stream |
140
+
| POST |[`/2/activity/subscriptions`](/x-api/activity/create-x-activity-subscription)| Create a subscription |
141
+
| GET |[`/2/activity/subscriptions`](/x-api/activity/get-x-activity-subscriptions)| List subscriptions |
142
+
| PUT |[`/2/activity/subscriptions/:id`](/x-api/activity/update-x-activity-subscription)| Update a subscription |
143
+
| DELETE |[`/2/activity/subscriptions/:id`](/x-api/activity/deletes-x-activity-subscription)| Delete a subscription |
144
144
145
145
<Note>
146
146
**Account setup**
@@ -150,11 +150,11 @@ To access these endpoints, you will need:
150
150
* An approved [developer account](https://developer.x.com/en/portal/petition/essential/basic-info).
151
151
* To authenticate using the keys and tokens from a [developer App](/resources/fundamentals/developer-apps) that is located within a [Project](/resources/fundamentals/projects).
152
152
153
-
Learn more about getting access to the X API v2 endpoints in our [getting started guide](/enterprise-api/getting-started/getting-access).
153
+
Learn more about getting access to the X API v2 endpoints in our [getting started guide](/x-api/getting-started/getting-access).
Copy file name to clipboardExpand all lines: enterprise-api/activity/quickstart.mdx
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -108,7 +108,7 @@ Upon successful request, your subscription will be created:
108
108
109
109
## Getting the events
110
110
111
-
Once we have created the subscription, we can receive the events via [webhooks](https://docs.x.com/enterprise-api/webhooks/introduction) or a persistent HTTP stream. In this example, we will open the persistent HTTP stream:
111
+
Once we have created the subscription, we can receive the events via [webhooks](https://docs.x.com/x-api/webhooks/introduction) or a persistent HTTP stream. In this example, we will open the persistent HTTP stream:
- The `tag` field is optional. This can be used to help identify events on delivery.
161
-
- The `webhook_id` field is also optional. See our [webhook docs](https://docs.x.com/enterprise-api/webhooks/introduction) forhelp setting up a webhook. If a `webhook_id` is specified, the event will be delivered to the provided webhook,in addition to the stream if it is open.
161
+
- The `webhook_id` field is also optional. See our [webhook docs](https://docs.x.com/x-api/webhooks/introduction) forhelp setting up a webhook. If a `webhook_id` is specified, the event will be delivered to the provided webhook,in addition to the stream if it is open.
0 commit comments