diff --git a/src/data/nav/platform.ts b/src/data/nav/platform.ts
index 8e1df1417d..ea6fe4f7aa 100644
--- a/src/data/nav/platform.ts
+++ b/src/data/nav/platform.ts
@@ -272,8 +272,8 @@ export default {
index: true,
},
{
- name: 'User management',
- link: '/docs/platform/account/users',
+ name: 'Team',
+ link: '/docs/platform/account/team',
},
{
name: 'Organizations',
@@ -291,40 +291,6 @@ export default {
name: 'Enterprise customization',
link: '/docs/platform/account/enterprise-customization',
},
- {
- name: 'App management',
- pages: [
- {
- name: 'Overview',
- link: '/docs/platform/account/app',
- index: true,
- },
- {
- name: 'Stats',
- link: '/docs/platform/account/app/stats',
- },
- {
- name: 'API keys',
- link: '/docs/platform/account/app/api',
- },
- {
- name: 'Queues',
- link: '/docs/platform/account/app/queues',
- },
- {
- name: 'Notifications',
- link: '/docs/platform/account/app/notifications',
- },
- {
- name: 'Dev console',
- link: '/docs/platform/account/app/console',
- },
- {
- name: 'Settings',
- link: '/docs/platform/account/app/settings',
- },
- ],
- },
{
name: 'Programmatic management using Control API',
link: '/docs/platform/account/control-api',
diff --git a/src/images/content/screenshots/control-api/account-settings-menu-item.png b/src/images/content/screenshots/control-api/account-settings-menu-item.png
deleted file mode 100644
index f770793674..0000000000
Binary files a/src/images/content/screenshots/control-api/account-settings-menu-item.png and /dev/null differ
diff --git a/src/images/content/screenshots/control-api/my-access-tokens-menu-item.png b/src/images/content/screenshots/control-api/my-access-tokens-menu-item.png
deleted file mode 100644
index 76e440c8c8..0000000000
Binary files a/src/images/content/screenshots/control-api/my-access-tokens-menu-item.png and /dev/null differ
diff --git a/src/images/content/screenshots/dash/access-token-set.png b/src/images/content/screenshots/dash/access-token-set.png
new file mode 100644
index 0000000000..4f55a5b8be
Binary files /dev/null and b/src/images/content/screenshots/dash/access-token-set.png differ
diff --git a/src/images/content/screenshots/dash/access-token.png b/src/images/content/screenshots/dash/access-token.png
new file mode 100644
index 0000000000..5ece95e3bc
Binary files /dev/null and b/src/images/content/screenshots/dash/access-token.png differ
diff --git a/src/images/content/screenshots/dash/account.png b/src/images/content/screenshots/dash/account.png
deleted file mode 100644
index 138c5db320..0000000000
Binary files a/src/images/content/screenshots/dash/account.png and /dev/null differ
diff --git a/src/images/content/screenshots/dash/cli.png b/src/images/content/screenshots/dash/cli.png
new file mode 100644
index 0000000000..70d07d4eef
Binary files /dev/null and b/src/images/content/screenshots/dash/cli.png differ
diff --git a/src/images/content/screenshots/dash/create-app.png b/src/images/content/screenshots/dash/create-app.png
deleted file mode 100644
index acb9cea59b..0000000000
Binary files a/src/images/content/screenshots/dash/create-app.png and /dev/null differ
diff --git a/src/images/content/screenshots/dash/dash-tabs.png b/src/images/content/screenshots/dash/dash-tabs.png
deleted file mode 100644
index 48b3a570e2..0000000000
Binary files a/src/images/content/screenshots/dash/dash-tabs.png and /dev/null differ
diff --git a/src/images/content/screenshots/dash/programmatic-man.png b/src/images/content/screenshots/dash/programmatic-man.png
new file mode 100644
index 0000000000..7de103fa7c
Binary files /dev/null and b/src/images/content/screenshots/dash/programmatic-man.png differ
diff --git a/src/images/content/screenshots/dash/stats-chart.png b/src/images/content/screenshots/dash/stats-chart.png
deleted file mode 100644
index ddf94f80d7..0000000000
Binary files a/src/images/content/screenshots/dash/stats-chart.png and /dev/null differ
diff --git a/src/images/content/screenshots/dash/stats-table.png b/src/images/content/screenshots/dash/stats-table.png
deleted file mode 100644
index b1953086cf..0000000000
Binary files a/src/images/content/screenshots/dash/stats-table.png and /dev/null differ
diff --git a/src/images/content/screenshots/dash/your-apps.png b/src/images/content/screenshots/dash/your-apps.png
deleted file mode 100644
index 94576b4fa0..0000000000
Binary files a/src/images/content/screenshots/dash/your-apps.png and /dev/null differ
diff --git a/src/pages/docs/auth/index.mdx b/src/pages/docs/auth/index.mdx
index 88058a1694..ccb7222bad 100644
--- a/src/pages/docs/auth/index.mdx
+++ b/src/pages/docs/auth/index.mdx
@@ -18,6 +18,8 @@ redirect_from:
- /docs/general/authentication
- /docs/general/_authentication_capabilities
- /docs/ids-and-keys
+ - /docs/account/app/api
+ - /docs/platform/account/app/api
---
All interactions between a client and the Ably service must be authenticated.
diff --git a/src/pages/docs/channels/options/encryption.mdx b/src/pages/docs/channels/options/encryption.mdx
index 645114aeb5..3886e880f9 100644
--- a/src/pages/docs/channels/options/encryption.mdx
+++ b/src/pages/docs/channels/options/encryption.mdx
@@ -32,7 +32,7 @@ Unencrypted communication with Ably is **disallowed** if any of the following co
* You attempt to use [Basic Authentication](/docs/auth/basic) and thus transmit a private API key over an unencrypted connection. You are only permitted to use unencrypted connections with [Token Authentication](/docs/auth/token) as tokens expire, limiting the impact of token interception.
-* You have specified that TLS is required in your [app settings](/docs/platform/account/app/settings).
+* You have specified that TLS is required in your [app settings](https://ably.com/accounts/any/apps/any/edit).
* A client using an unencrypted connection attempts to attach to a channel that is configured to be used with [TLS only](/docs/channels#rules).
diff --git a/src/pages/docs/metadata-stats/metadata/subscribe.mdx b/src/pages/docs/metadata-stats/metadata/subscribe.mdx
index dfddb17ba8..d9e90097bf 100644
--- a/src/pages/docs/metadata-stats/metadata/subscribe.mdx
+++ b/src/pages/docs/metadata-stats/metadata/subscribe.mdx
@@ -58,7 +58,7 @@ The `data` property of all events is a [`ChannelDetails`](/docs/api/realtime-sdk
### Regional channel activity
The account owner must already have 2FA enabled for their own login before they can enforce it account-wide.
@@ -50,16 +50,14 @@ The account owner must already have 2FA enabled for their own login before they
To enforce 2FA for all users:
-1. Log in to your [account](https://ably.com/accounts/any).
-2. Select **Settings** from the account navigation dropdown.
-3. Toggle **Require Two-Factor Authentication for all account users** under the **Authentication Settings** section.
-4. **Save** the authentication settings.
+1. Log in to your account and select [Profile Settings](https://ably.com/users/edit) in your account.
+2. Toggle **Require Two-Factor Authentication for all account users** under the **Authentication Settings** section.
+3. **Save** the authentication settings.
### Remove 2FA requirement of all users
-Before setting up multiple API keys with different permissions or sharing API keys with untrusted parties, consider using [token authentication](/docs/auth/token) instead. Token authentication provides more flexible access control and better security for client-side applications.
-
-
-## Create a new API key
-A single API key cannot support complex permission combinations, such as publish access on one channel and subscribe access on another. For such requirements, use [token authentication](/docs/auth/token) instead.
-
-
-### Revocable tokens
-
-[Revocable tokens](/docs/auth/revocation#revocable-tokens) enhance security by allowing shorter token lifetimes and the ability to revoke tokens issued via the API key.
-
-| Option | Description |
-| ------ | ----------- |
-| Revocable tokens | Implement security measures by setting shorter token lifetimes and enabling the ability to revoke tokens issued by the API key. |
-
-### Change your API key settings
-
-Click **Settings** on the required API key to change its settings. The same settings apply as when creating a new API key.
diff --git a/src/pages/docs/platform/account/app/console.mdx b/src/pages/docs/platform/account/app/console.mdx
deleted file mode 100644
index aec15bb350..0000000000
--- a/src/pages/docs/platform/account/app/console.mdx
+++ /dev/null
@@ -1,79 +0,0 @@
----
-title: Dev console
-meta_description: "Gain realtime insights into application-wide events, such as connection status changes, channel activity, and event logs.”
-meta_keywords: “Ably dev console, realtime monitoring, connection status changes, channel activity, event logs"
-redirect_from:
- - /docs/account/app/console
----
-
-The dev console tab provides realtime insights into application-wide events, such as connection status changes and channel activity. These features enable you to:
-
-* Observe changes in connection status across the application.
-* View activity on specific channels, including message traffic and channel events.
-* Examine event logs to troubleshoot your application.
-
-## Application-wide events interface
-
-The application-wide events interface allows you to monitor your application's health and activity in realtime.
-
-The following explains the realtime monitoring tools in the application-wide events interface:
-
-| Field | Description |
-| ----- | ----------- |
-| **API key** | The API key to access and view events within the app. |
-| **Average application-wide events per second (p/s)** | This metric shows the average number of events occurring per second across your application. For example, if the current rate is 0, no active events are being processed. |
-| **Event log table** | The event log table displays a record of events related to the current client's connection status. This table can be used to debug potential issues in your application. |
-
-## Message auditing and logging
-Account limits are shared. While apps are sandboxed from each other, they share the same [account limits](/docs/platform/pricing/limits) such as connection counts and channel limits. A development app experiencing high usage could potentially impact your production app if account limits are reached.
-
-
-## App overview
-
-Your app dashboard provides the following tabs for monitoring and configuring your app settings:
-
-
-
-### Stats
-
-Monitor and analyze your app's performance through a [stats](/docs/platform/account/app/stats) table and chart:
-
-* Track messages, presence events, and performance metrics to understand usage and capacity.
-* Compare data over time to identify trends and optimize resources.
-* Adjust chart views with zoom options and set specific time ranges for detailed insights.
-
-### Getting started
-
-Get started by connecting to Ably, and publishing your first message.
-
-### API keys
-
-Create, manage, and configure [API keys](/docs/platform/account/app/api) by setting capabilities:
-
-* Users can create a new API key, assigning a descriptive name for easy identification.
-* Capabilities include permissions like publishing messages, subscribing to channels, retrieving message history, managing presence, and accessing statistics.
-* Control access by defining whether the key has unrestricted access, channel-only, queue-only, or specific access to selected channels and queues.
-
-### Integrations
-
-[Integrate](/docs/platform/integrations) Ably with external services, enabling data to flow between Ably channels and third-party platforms:
-
-* Ably events can trigger webhook requests to external services, or external services can send data to Ably using incoming webhooks.
-* Ably enables continuous streaming of events to external services like Amazon Kinesis or Kafka, or can receive inbound streams from external services.
-* Ably supports various integration methods, including HTTP callbacks, cloud functions, and streaming services.
-
-### Queues
-
-View, monitor, and adjust Ably [queues:](/docs/platform/account/app/queues)
-
-* Queues provide access to manage existing queues, monitor data flow, and adjust settings such as TTL, max length, and region.
-* Users can contact Ably support for assistance with increasing limits or customizing their queue settings.
-
-### Notifications
-
-Manage [notifications](/docs/platform/account/app/notifications) using Ably. Create, test, and send notifications to specific devices or channels, and enure everything works correctly.
-
-* Configure push notifications for devices using FCM for Android or APNs for iOS.
-* Use the push inspector tool to test and debug notifications by sending them manually and reviewing device, client, and channel registrations.
-* Use the push inspector widget below to browse and inspect channel subscriptions, device and client registrations.
-
-### Dev console
-
-Monitor your application's health in realtime using Ably's [dev console](/docs/platform/account/app/console) by -- tracking events like connection status changes and channel activity. Connect to channels, publish messages, manage presence, and view event logs for troubleshooting:
-
-* The dev console provides realtime insights into application-wide events like connection status changes, channel activity, and event logs.
-* You can connect to channels, publish messages, and manage presence, tracking interactions within the channel through the console.
-* The event log table displays detailed records of connection events, which can be used for troubleshooting and diagnosing application issues.
-* Interact with Ably channels using command-line tools like cURL.
-
-### Settings
-
-Manage key aspects of your application [settings](/docs/platform/account/app/settings), including security, enabling or disabling the app, configuring rules for channels, and setting up protocol support for different SDKs:
-
-* Manage settings like App ID, name, security (TLS), and enable/disable the application, affecting its ability to accept connections and use Ably services.
-* Create rules to enforce settings for specific channels, or channel namespaces, such as message persistence, TLS-only access, push notifications, and server-side batching.
-* Enable compatibility with various protocols like Pusher, PubNub, and MQTT for communication between client libraries and Ably.
-* Manage notifications for channel activity and occupancy to gain realtime insights into channel usage and performance.
-
diff --git a/src/pages/docs/platform/account/app/notifications.mdx b/src/pages/docs/platform/account/app/notifications.mdx
deleted file mode 100644
index 6e17b52961..0000000000
--- a/src/pages/docs/platform/account/app/notifications.mdx
+++ /dev/null
@@ -1,75 +0,0 @@
----
-title: Notifications
-meta_description: Configure credentials for integrating Ably's push notification services with third-party services, send push notifications from the Ably dashboard, and inspect push notifications .”
-meta_keywords: “Ably push notifications, configure FCM, configure APNs, Web Push setup, push inspector"
-redirect_from:
- - /docs/account/app/notifications
----
-
-Before you can start using Ably's [push notification](/docs/push) services, you must configure the credentials for the third-party services you wish to integrate, such as FCM for Android devices, APNs for iOS devices, or Web Push for web browsers.
-
-### Configure FCM for Android devices
-Download or view detailed app statistics for a more granular analysis, enabling deeper dives into specific metrics as needed.
-
-
-## Statistics chart
When modifying an individual user's roles, any rights assigned via groups will be greyed out and cannot be changed directly.
diff --git a/src/pages/docs/platform/account/sso.mdx b/src/pages/docs/platform/account/sso.mdx
index 31388d71db..861eb8a667 100644
--- a/src/pages/docs/platform/account/sso.mdx
+++ b/src/pages/docs/platform/account/sso.mdx
@@ -10,7 +10,7 @@ Single sign-on (SSO) enables your users to authenticate via any SAML-compatible
## Configure
+Follow [this process](https://faqs.ably.com/can-i-change-my-ably-account-owner) to transfer account ownership.
+
+
+## Invite a new user
+You can view the status of pending invitations from the Users page. You can also re-send or revoke an invitation.
+
+
+## Remove users from an account
+Account owners: Deleting your profile will delete the entire account and all data. You must first [transfer ownership](https://faqs.ably.com/can-i-change-my-ably-account-owner) to another user before deleting your profile.
+
+
+## Close your account
+You will not be able to delete your account until the 1st of the month following your downgrade, after your final invoice has been paid.
+
+
+4. [Disconnect SSO provider](#sso) if you use SSO to log in.
+5. Go to the [Account Settings](https://ably.com/accounts/any/settings) page.
+6. Select **Delete account** and follow the prompts.
+
+
+If you use an SSO login you'll see a "Contact us" link instead of a "Start" button. [Disconnect your SSO provider](#sso) first.
+
+
+### Disconnect SSO provider
-Follow [this process](https://faqs.ably.com/can-i-change-my-ably-account-owner) to transfer account ownership.
-
-
-## Invite a new user
-You can view the status of pending invitations from the Users page. You can also re-send or revoke an invitation.
-
-
-## Remove users from an account
-**Account owners:** Deleting your profile will delete the entire account and all data. You must first [transfer ownership](https://faqs.ably.com/can-i-change-my-ably-account-owner) to another user before deleting your profile.
-
-
-## Close your account
-You will not be able to delete your account until the 1st of the month following your downgrade, after your final invoice has been paid.
-
-
-5. [Disconnect SSO provider](#sso) if you use SSO to log in.
-6. Go to your [My Settings](https://ably.com/users/edit) page.
-7. Scroll to Want to delete your profile?
-
-
-If you are using an SSO login you'll see a Contact us link instead of a Start button. You'll need to [disconnect your SSO provider](#sso) first.
-
-
-8. Click Start to proceed with permanently closing your account.
-9. On the proceeding Close Your Ably Account page, review the accounts for closure.
-10. Click Close Account to permanently deactivate your account.
-
-### Disconnect SSO provider
-The Dev console displays a realtime feed of events. It does not store historical data, so you won't be able to query past events after an error has occurred.
+Note the web client was previously known as the Dev Console.
## Support tickets
Be aware that this will permanently delete all information associated with your account.
diff --git a/src/pages/docs/platform/pricing/pro.mdx b/src/pages/docs/platform/pricing/pro.mdx
index 7b7ac219c4..57ac03f1d0 100644
--- a/src/pages/docs/platform/pricing/pro.mdx
+++ b/src/pages/docs/platform/pricing/pro.mdx
@@ -39,7 +39,7 @@ Pro package support includes access to Ably support via email with a Service Lev
To upgrade your account from a Free package to a Pro package:
-1. Ensure you are the [account owner](/docs/platform/account/users).
+1. Ensure you are the [account owner](/docs/platform/account/team).
2. Log in to your [account](https://ably.com/login) and select **Billing** from the **Account** menu.
3. Choose the plan you wish to upgrade to and follow the instructions. Upgrades take effect immediately.
@@ -51,7 +51,7 @@ Once you upgrade to a Pro, your usage is counted from that point onwards. For ex
To upgrade your account from a Standard package to a Pro package:
-1. Ensure you are the [account owner](/docs/platform/account/users).
+1. Ensure you are the [account owner](/docs/platform/account/team).
2. Log in to your [account](https://ably.com/login) and select **Billing** from the **Account** menu.
3. Choose the plan you wish to upgrade to and follow the instructions. Upgrades take effect immediately.
@@ -65,7 +65,7 @@ To upgrade your account from a Pro package, [contact us](https://ably.com/contac
To downgrade your account from a Pro package:
-1. Ensure you are the [account owner](/docs/platform/account/users).
+1. Ensure you are the [account owner](/docs/platform/account/team).
2. Log in to your [account](https://ably.com/login) and select **Billing** from the **Account** menu.
3. Click the **Downgrade** button.
@@ -75,7 +75,7 @@ If you downgrade to the [Standard package](/docs/platform/pricing/standard), you
## Close your account
Be aware that this will permanently delete all information associated with your account.
diff --git a/src/pages/docs/platform/pricing/standard.mdx b/src/pages/docs/platform/pricing/standard.mdx
index bf90a4b1b8..d9a83ef34f 100644
--- a/src/pages/docs/platform/pricing/standard.mdx
+++ b/src/pages/docs/platform/pricing/standard.mdx
@@ -39,7 +39,7 @@ Standard package support includes access to Ably support via email with a Servic
To upgrade your account from a Free package to a Standard package:
-1. Ensure you are the [account owner](/docs/platform/account/users).
+1. Ensure you are the [account owner](/docs/platform/account/team).
2. Log in to your [account](https://ably.com/login) and select **Billing** from the **Account** menu.
3. Choose the plan you wish to upgrade to and follow the instructions. Upgrades take effect immediately.
@@ -51,7 +51,7 @@ Once you upgrade to a Standard, your usage is counted from that point onwards. F
To upgrade your account from a Standard package to a Pro package:
-1. Ensure you are the [account owner](/docs/platform/account/users).
+1. Ensure you are the [account owner](/docs/platform/account/team).
2. Log in to your [account](https://ably.com/login) and select **Billing** from the **Account** menu.
3. Choose the plan you wish to upgrade to and follow the instructions. Upgrades take effect immediately.
@@ -65,7 +65,7 @@ To upgrade your account from a Standard package to an [Enterprise package](/docs
To downgrade your account from a Standard package to Free:
-1. Ensure you are the [account owner](/docs/platform/account/users).
+1. Ensure you are the [account owner](/docs/platform/account/team).
2. Log in to your [account](https://ably.com/login) and select **Billing** from the **Account** menu.
3. Click the **Downgrade** button.
@@ -73,7 +73,7 @@ If you downgrade to the [Free package](/docs/platform/pricing/free), you will re
## Close your account
Be aware that this will permanently delete all information associated with your account.
diff --git a/src/pages/docs/platform/tools/cli.mdx b/src/pages/docs/platform/tools/cli.mdx
index fcd61f7dda..50321ba4af 100644
--- a/src/pages/docs/platform/tools/cli.mdx
+++ b/src/pages/docs/platform/tools/cli.mdx
@@ -8,7 +8,9 @@ meta_keywords: "Ably CLI, command line, terminal, developer tools"
The [Ably CLI](https://github.com/ably/ably-cli) is currently in Public Preview status.
-The Ably CLI brings the full power of Ably to your terminal. You can use it to manage your Ably account and its resources, and to explore Ably's APIs and features.
+The Ably CLI brings the full power of Ably to your terminal. You can use it to manage your Ably account and its resources, and to explore Ably's APIs and features. The same capabilities are also available in the CLI section of the [Ably dashboard](https://ably.com/accounts/any/apps/any/).
+
+
It's a quick and easy way to simulate additional clients when testing how Ably works.
diff --git a/src/pages/docs/push/index.mdx b/src/pages/docs/push/index.mdx
index 149cad093e..11d7950c22 100644
--- a/src/pages/docs/push/index.mdx
+++ b/src/pages/docs/push/index.mdx
@@ -13,6 +13,8 @@ redirect_from:
- /docs/general/push-notifications
- /docs/general/versions/v0.8/push-notifications
- /docs/general/smart-notifications
+ - /docs/account/app/notifications
+ - /docs/platform/account/app/notifications
---
Push notifications notify user devices or browsers regardless of whether an application is open and running. They deliver information, such as app updates, social media alerts, or promotional offers, directly to the user's screen. Ably sends push notifications to devices using [Firebase Cloud Messaging](https://firebase.google.com/docs/cloud-messaging) or [Apple Push Notification Service](https://developer.apple.com/notifications/), and to browsers using [Web Push](https://developer.mozilla.org/en-US/docs/Web/API/Push_API). Push notifications don't require a device or browser to stay connected to Ably. Instead, a device's or browser's operating system or web browser maintains its own battery-efficient transport to receive notifications.