From e33d874bcea5d58987bc18d85669cfdb16b07077 Mon Sep 17 00:00:00 2001
From: nael <ouldbelkacemnael@yahoo.fr>
Date: Thu, 19 Sep 2024 01:40:33 +0200
Subject: [PATCH] :memo: Updated docs

---
 apps/magic-link/Dockerfile                    |  2 +
 apps/magic-link/Dockerfile.dev                |  2 +
 apps/magic-link/src/helpers/config.ts         |  1 +
 apps/magic-link/src/lib/ProviderModal.tsx     |  6 ++-
 .../app/(Dashboard)/configuration/page.tsx    |  2 +-
 .../hooks/create/useCreatePullFrequency.tsx   |  2 +-
 .../src/hooks/get/useGetPullFrequencies.tsx   |  4 +-
 docker-compose.dev.yml                        |  1 +
 docker-compose.source.yml                     |  1 +
 docker-compose.yml                            |  2 +-
 docs/api-reference/authentication.mdx         |  2 +-
 docs/backend-sdk/python.mdx                   |  2 +-
 docs/backend-sdk/typescript.mdx               |  2 +-
 docs/core-concepts/auth.mdx                   |  4 +-
 docs/core-concepts/custom-fields.mdx          |  2 +-
 docs/core-concepts/magic-links.mdx            |  6 +--
 docs/core-concepts/sync-strategies.mdx        | 24 +++++++++-
 docs/quick-start.mdx                          | 22 ++++++---
 docs/rag/index.mdx                            | 11 ++++-
 docs/recipes/add-custom-provider-creds.mdx    |  2 +-
 docs/recipes/catch-connection-token.mdx       | 10 ++--
 docs/recipes/embed-catalog.mdx                |  2 +-
 docs/recipes/import-existing-users.mdx        | 12 ++---
 docs/webhooks/overview.mdx                    | 10 ++--
 .../linked-users/linked-users.controller.ts   | 26 +++++------
 .../api/src/@core/sync/sync.controller.ts     |  8 ++--
 packages/api/swagger/swagger-spec.yaml        | 46 +++++++++----------
 27 files changed, 133 insertions(+), 81 deletions(-)

diff --git a/apps/magic-link/Dockerfile b/apps/magic-link/Dockerfile
index 8e9a8cad1..f6701c5cb 100644
--- a/apps/magic-link/Dockerfile
+++ b/apps/magic-link/Dockerfile
@@ -27,8 +27,10 @@ ENV PNPM_HOME="/pnpm"
 ENV PATH="$PNPM_HOME:$PATH"
 
 ARG VITE_BACKEND_DOMAIN
+ARG VITE_WEBAPP_DOMAIN
 
 ENV VITE_BACKEND_DOMAIN="$VITE_BACKEND_DOMAIN"
+ENV VITE_WEBAPP_DOMAIN="$VITE_WEBAPP_DOMAIN"
 
 RUN corepack enable
 
diff --git a/apps/magic-link/Dockerfile.dev b/apps/magic-link/Dockerfile.dev
index 26cdf0048..d75210253 100644
--- a/apps/magic-link/Dockerfile.dev
+++ b/apps/magic-link/Dockerfile.dev
@@ -11,8 +11,10 @@ ENV PNPM_HOME="/pnpm"
 ENV PATH="$PNPM_HOME:$PATH"
 
 ARG VITE_BACKEND_DOMAIN
+ARG VITE_WEBAPP_DOMAIN
 
 ENV VITE_BACKEND_DOMAIN="$VITE_BACKEND_DOMAIN"
+ENV VITE_WEBAPP_DOMAIN="$VITE_WEBAPP_DOMAIN"
 
 RUN corepack enable
 
diff --git a/apps/magic-link/src/helpers/config.ts b/apps/magic-link/src/helpers/config.ts
index 32cb9c4cc..e4ec62a3f 100644
--- a/apps/magic-link/src/helpers/config.ts
+++ b/apps/magic-link/src/helpers/config.ts
@@ -1,5 +1,6 @@
 const config = {
     API_URL: import.meta.env.VITE_BACKEND_DOMAIN,
+    WEBAPP_URL: import.meta.env.VITE_WEBAPP_DOMAIN
 };
   
 export default config;
diff --git a/apps/magic-link/src/lib/ProviderModal.tsx b/apps/magic-link/src/lib/ProviderModal.tsx
index ed94c384b..54d03011b 100644
--- a/apps/magic-link/src/lib/ProviderModal.tsx
+++ b/apps/magic-link/src/lib/ProviderModal.tsx
@@ -7,6 +7,7 @@ import {
 import { Input } from "@/components/ui/input";
 import { LoadingSpinner } from '@/components/ui/loading-spinner';
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select';
+import config from '@/helpers/config';
 import useCreateApiKeyConnection from '@/hooks/queries/useCreateApiKeyConnection';
 import useProjectConnectors from '@/hooks/queries/useProjectConnectors';
 import useUniqueMagicLink from '@/hooks/queries/useUniqueMagicLink';
@@ -419,7 +420,10 @@ const ProviderModal = () => {
               <span className="text-sm">You've successfully connected your account!</span>
             </div>
             <button 
-              onClick={() => CloseSuccessDialog(false)}
+              onClick={() => {
+                CloseSuccessDialog(false)
+                window.location.href = config.WEBAPP_URL;
+              }}
               className="mt-4 px-6 py-2 bg-black text-white rounded-lg font-semibold hover:bg-gray-100 hover:text-black transition-colors"
             >
               Go to Dashboard
diff --git a/apps/webapp/src/app/(Dashboard)/configuration/page.tsx b/apps/webapp/src/app/(Dashboard)/configuration/page.tsx
index 8c79032f8..c5b24c01c 100644
--- a/apps/webapp/src/app/(Dashboard)/configuration/page.tsx
+++ b/apps/webapp/src/app/(Dashboard)/configuration/page.tsx
@@ -145,7 +145,7 @@ export default function Page() {
         {
           loading: 'Updating...',
           success: (data: any) => {
-            queryClient.setQueryData<any>(['pull-frequencies'], (oldData: any) => ({
+            queryClient.setQueryData<any>(['pull_frequencies'], (oldData: any) => ({
               ...oldData,
               [vertical]: frequency.toString(),
             }));
diff --git a/apps/webapp/src/hooks/create/useCreatePullFrequency.tsx b/apps/webapp/src/hooks/create/useCreatePullFrequency.tsx
index ccd6fd968..6f6c71393 100644
--- a/apps/webapp/src/hooks/create/useCreatePullFrequency.tsx
+++ b/apps/webapp/src/hooks/create/useCreatePullFrequency.tsx
@@ -6,7 +6,7 @@ export type UpdatePullFrequencyData = Record<string, number>;
 
 export const useUpdatePullFrequency = () => {
     const add = async (data: UpdatePullFrequencyData) => {
-        const response = await fetch(`${config.API_URL}/sync/internal/pull-frequencies`, {
+        const response = await fetch(`${config.API_URL}/sync/internal/pull_frequencies`, {
         method: 'POST',
         headers: {
             'Content-Type': 'application/json',
diff --git a/apps/webapp/src/hooks/get/useGetPullFrequencies.tsx b/apps/webapp/src/hooks/get/useGetPullFrequencies.tsx
index e7b8d4d45..0fed04cd3 100644
--- a/apps/webapp/src/hooks/get/useGetPullFrequencies.tsx
+++ b/apps/webapp/src/hooks/get/useGetPullFrequencies.tsx
@@ -6,9 +6,9 @@ import Cookies from 'js-cookie';
 
 const usePullFrequencies = () => {
   return useQuery({
-    queryKey: ['pull-frequencies'], 
+    queryKey: ['pull_frequencies'], 
     queryFn: async (): Promise<PullFrequency> => {
-      const response = await fetch(`${config.API_URL}/sync/internal/pull-frequencies`,{
+      const response = await fetch(`${config.API_URL}/sync/internal/pull_frequencies`,{
         method: 'GET',
         headers: {
             'Content-Type': 'application/json', 
diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml
index 6bfe5872b..5fae555af 100644
--- a/docker-compose.dev.yml
+++ b/docker-compose.dev.yml
@@ -280,6 +280,7 @@ services:
       context: ./
       args:
         VITE_BACKEND_DOMAIN: http://localhost:3000
+        VITE_WEBAPP_DOMAIN: http://localhost
     restart: always
     ports:
       - 81:5173
diff --git a/docker-compose.source.yml b/docker-compose.source.yml
index 4de1e850b..cec689480 100644
--- a/docker-compose.source.yml
+++ b/docker-compose.source.yml
@@ -277,6 +277,7 @@ services:
       context: ./
       args:
         VITE_BACKEND_DOMAIN: ${NEXT_PUBLIC_BACKEND_DOMAIN}
+        VITE_WEBAPP_DOMAIN: ${NEXT_PUBLIC_WEBAPP_DOMAIN}
     restart: always 
     ports:
       - 81:80
diff --git a/docker-compose.yml b/docker-compose.yml
index e91cf788e..af468921a 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -252,7 +252,7 @@ services:
         condition: service_healthy
     networks:
       - backend
-      - frontend
+      - frontend 
 
   webapp-next:
     image: panora.docker.scarf.sh/panoradotdev/frontend-webapp:selfhosted
diff --git a/docs/api-reference/authentication.mdx b/docs/api-reference/authentication.mdx
index d15d68823..f24f60a3c 100644
--- a/docs/api-reference/authentication.mdx
+++ b/docs/api-reference/authentication.mdx
@@ -3,7 +3,7 @@ title: "Authentication"
 description: ""
 ---
 
-The Panora API uses [API keys](/core-concepts/auth) to authenticate requests. You can view and manage your API keys in the [Panora Dashboard](https://dashboard.panora.dev/api-keys).
+The Panora API uses [API keys](/core-concepts/auth) to authenticate requests. You can view and manage your API keys in the [Panora Dashboard](https://app.panora.dev/api-keys).
 
 Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.
 
diff --git a/docs/backend-sdk/python.mdx b/docs/backend-sdk/python.mdx
index 39d331937..2d125c856 100644
--- a/docs/backend-sdk/python.mdx
+++ b/docs/backend-sdk/python.mdx
@@ -14,7 +14,7 @@ poetry add panora-sdk
 ```
 Instantiate the SDK:
 
-<Tip>Go to your dashboard to get your [API Key](https://dashboard.panora.dev/api-keys)</Tip>
+<Tip>Go to your dashboard to get your [API Key](https://app.panora.dev/api-keys)</Tip>
 
 ```python
 import os
diff --git a/docs/backend-sdk/typescript.mdx b/docs/backend-sdk/typescript.mdx
index 5513bb14f..72ccc8c62 100644
--- a/docs/backend-sdk/typescript.mdx
+++ b/docs/backend-sdk/typescript.mdx
@@ -15,7 +15,7 @@ npm i @panora/sdk
 
 Instantiate the SDK:
 
-<Tip>Go to your dashboard to get your [API Key](https://dashboard.panora.dev/api-keys)</Tip>
+<Tip>Go to your dashboard to get your [API Key](https://app.panora.dev/api-keys)</Tip>
 
 ```javascript
 import { Panora } from "@panora/sdk";
diff --git a/docs/core-concepts/auth.mdx b/docs/core-concepts/auth.mdx
index a9974b6d3..7cc902c35 100644
--- a/docs/core-concepts/auth.mdx
+++ b/docs/core-concepts/auth.mdx
@@ -33,7 +33,7 @@ Depending on your setup, you should make requests to one of those endpoints:
 
 
     **Creating your API Key**  <br/>      
-    Go to your [dashboard](https://dashboard.panora.dev), and visit the _API Keys_ [section](https://dashboard.panora.dev/api-keys). Click the `Create New Key` button.
+    Go to your [dashboard](https://app.panora.dev), and visit the _API Keys_ [section](https://app.panora.dev/api-keys). Click the `Create New Key` button.
     <Frame type="glass">
         <img src="/images/api-keys.png" />
     </Frame>
@@ -74,7 +74,7 @@ We also recommend practising by looking at the specific verticals you want to in
 
 <Info>
   You can find the Typescript SDK on NPM
-  [here](https://www.npmjs.com/package/@panora/sdk-typescript)
+  [here](https://www.npmjs.com/package/@panora/sdk)
 </Info>
 In this example, we will create a contact in a CRM. Visit other sections of the [documentation](/ticketing/overview) to find category-specific examples.
 <CodeGroup>
diff --git a/docs/core-concepts/custom-fields.mdx b/docs/core-concepts/custom-fields.mdx
index cbd520862..360d7600d 100644
--- a/docs/core-concepts/custom-fields.mdx
+++ b/docs/core-concepts/custom-fields.mdx
@@ -29,7 +29,7 @@ You must have a connection, hence a valid linked user so you can create custom f
 <Steps>
 
     <Step title="Login to your Dashboard">
-    Login to your [account dashboard](https://dashboard.panora.dev) and click on _Configuration_ [section](https://dashboard.panora.dev/configuration) and go to tab **Field Mapping**.
+    Login to your [account dashboard](https://app.panora.dev) and click on _Configuration_ [section](https://app.panora.dev/configuration) and go to tab **Field Mapping**.
     </Step>
 
     <Step title="Define your custom field">
diff --git a/docs/core-concepts/magic-links.mdx b/docs/core-concepts/magic-links.mdx
index 71e3dcff6..c43afdf6b 100644
--- a/docs/core-concepts/magic-links.mdx
+++ b/docs/core-concepts/magic-links.mdx
@@ -19,10 +19,10 @@ icon: "wand-magic-sparkles"
 
 <Steps>
 
-<Step>Login to your [account dashboard](https://dashboard.panora.dev)</Step>
+<Step>Login to your [account dashboard](https://app.panora.dev)</Step>
 
 <Step>
-  Go to the _Connections_ [section](https://dashboard.panora.dev/connections)
+  Go to the _Connections_ [section](https://app.panora.dev/connections)
   and click button `Create a Magic Link`
 </Step>
 
@@ -39,5 +39,5 @@ icon: "wand-magic-sparkles"
 <Step>Click `Generate`</Step>
 
 </Steps>
-<Info> You may see CLIENT_ID not found for some providers. It means we don't have an OAuth Panora App published yet so you may need to input your own credentials. (see this [guide](/recipes/add-custom-provider-creds))</Info>
+<Note> You may see CLIENT_ID not found for some providers. It means we don't have an OAuth Panora App published yet so you may need to input your own credentials. (see this [guide](/recipes/add-custom-provider-creds))</Note>
 Once the user successfully completes the granting auth flow, the connection will have a `status` value of `valid`.
diff --git a/docs/core-concepts/sync-strategies.mdx b/docs/core-concepts/sync-strategies.mdx
index 26113406a..13e4a9dd2 100644
--- a/docs/core-concepts/sync-strategies.mdx
+++ b/docs/core-concepts/sync-strategies.mdx
@@ -17,4 +17,26 @@ Go to Configurations page, and apply the frequency to the category you wish to r
 
 <Frame>
   <img src="/images/frequency.png" alt="Description of image" />
-</Frame>
\ No newline at end of file
+</Frame>
+
+**You can also the API, just select a number of seconds for the vertical you want to have custom sync.**
+<CodeGroup>
+  ```shell Curl
+  curl --request POST \
+        --url https://api.panora.dev/sync/pull_frequencies \
+        --header 'x-api-key: <api-key>' \
+        --header 'Content-Type: application/json' \
+        --data '{
+          "crm": 300, 
+          "hris": 0,
+          "ticketing": 0,
+          "accounting": 0,
+          "ats": 0,
+          "ecommerce": 0,
+          "hris": 0,
+          "filestorage": 0,
+        }'
+  ```
+</CodeGroup>
+
+Here I just set up data to be synced every 5 minutes (300 seconds) for the CRM category.
\ No newline at end of file
diff --git a/docs/quick-start.mdx b/docs/quick-start.mdx
index 3bb1222ff..f4253d23f 100644
--- a/docs/quick-start.mdx
+++ b/docs/quick-start.mdx
@@ -8,7 +8,7 @@ icon: "star"
 
 Before you begin, make sure you have the following:
 
-- **Panora Running on your machine** (⏱️ 1 min self-hosting guide [here](/open-source/self_hosting/guide))
+- **An account on [our cloud](https://app.panora.dev) (⏱️ 15sec)** or **Panora Running on your machine** (⏱️ 1 min self-hosting guide [here](/open-source/self_hosting/guide))
 - **An API key** (⏱️ 1 min guide guide [here](/core-concepts/auth#learn-how-to-generate-your-api-keys))
 - **A free Hubspot account** (signup [here](https://app.hubspot.com/signup-hubspot/crm) - use a [disposable email](https://temp-mail.org/en/) if you prefer)
 
@@ -23,9 +23,9 @@ Let's now create our first magic link!
 
 
     <Steps>
-      <Step>Login to your [account dashboard](https://dashboard.panora.dev)</Step>
+      <Step>Login to your [account dashboard](https://app.panora.dev)</Step>
       <Step>
-        Go to _Connections_ [section](https://dashboard.panora.dev/connections) and click button `Create a Magic Link`
+        Go to _Connections_ [section](https://app.panora.dev/connections) and click button `Create a Magic Link`
       </Step>
       <Step>Click `Create a Unique Magic Link`</Step>
       <Step>
@@ -43,7 +43,7 @@ Let's now create our first magic link!
 ## Step 2: Grab the connection token
 
 Connection tokens are the way Panora represents a third party's account, whatever the underlying identification mechanism is.
-There are two ways to get these tokens: catchting them with a webhook, or just finding them in your dashboard. For now, we'll stick to the dashboard,.
+There are two ways to get these tokens: [catching them with a webhook](/recipes/catch-connection-token), or just finding them in your dashboard. For now, we'll stick to the dashboard.
 
 To find the `connection token` in the dashboard, visit the `connections` section. Copy the connection token from its column and save it.
 ![title](/images/connections_screen.png)
@@ -60,10 +60,20 @@ This will require you to have:
 The API key identifies _YOU_ as a user of Panora, while the connection token identifies which user's account you behalf you want to. In the future, you will have one connection token per user account connected on the Panora platform, while keeping one API key.
 
 You can copy past the Curl example below, and copy-paste it in your terminal. Don't forget to replace the API key and the connection token.
-
+<Note>
+  ONLY SELFHOST:
+  Replace `https://api.panora.dev` with `http://localhost:3000`.
+  If you use the SDK, include `serverURL: 'http://localhost:3000'` in the Panora client
+  ```javascript
+  const panora = new Panora({
+    serverURL: 'http://localhost:3000',
+    apiKey: process.env.API_KEY,
+  });
+  ```
+</Note>
       <CodeGroup>
          ```shell curl
-        curl --location 'http://localhost:3000/crm/contacts' \
+        curl --location 'https://api.panora.dev/crm/contacts' \
 --header 'x-connection-token: 7e6b9454-f616-477a-a71a-0f23eb74a72c' \
 --header 'x-api-key: sk_dev_30a78556-6a83-425x-b461-a87f007a09e1'
         ```
diff --git a/docs/rag/index.mdx b/docs/rag/index.mdx
index b29c7908e..72c570cc1 100644
--- a/docs/rag/index.mdx
+++ b/docs/rag/index.mdx
@@ -17,7 +17,16 @@ Once we've synced documents across File Storage systems, we embed and chunk them
 #### Use the SDK
 
 <CodeGroup>
-    ```javascript React
+    ```shell Curl
+    curl --request GET \
+            --url https://api.panora.dev/rag/query \
+            --header 'x-api-key: <api-key>' \
+            --data '{
+              "query": "When does Panora incorporated?"
+              "topK": 3
+            }'
+    ```
+    ```javascript Typescript
     import { Panora } from "@panora/sdk";
 
     const panora = new Panora({
diff --git a/docs/recipes/add-custom-provider-creds.mdx b/docs/recipes/add-custom-provider-creds.mdx
index a39d1fd08..5a7ed9f17 100644
--- a/docs/recipes/add-custom-provider-creds.mdx
+++ b/docs/recipes/add-custom-provider-creds.mdx
@@ -16,7 +16,7 @@ With Custom OAuth, you can supply your own Client Id and Client Secret and Panor
   inside your sofwtare's developer account.{" "}
 </Note>
 
-Visit the _Manage Connectors_ [section](https://dashboard.panora.dev/configuration), choose the connector you wish to add credentials for and add your own credentials.
+Visit the _Manage Connectors_ [section](https://app.panora.dev/configuration), choose the connector you wish to add credentials for and add your own credentials.
 
 <Frame type="glass">
   <video
diff --git a/docs/recipes/catch-connection-token.mdx b/docs/recipes/catch-connection-token.mdx
index 810632d75..1b5fc2a5e 100644
--- a/docs/recipes/catch-connection-token.mdx
+++ b/docs/recipes/catch-connection-token.mdx
@@ -77,7 +77,7 @@ It is a field of the [Connection Object](/glossary/connection-object) that Panor
         If you log `event.data`, you'll be able to check that it is a [Connection Object](/glossary/connection-object). Hence, it contains an `id_linked_user`(more info [here](/glossary/linked-account-object)) which is helpful to attach it to your own end-user on your backend/db systems.
     </Step>
     <Step title="Register your endpoint within Panora using the Dashboard or the API.">
-        Register the webhook endpoint’s accessible URL using the _Webhooks_ [section](https://dashboard.panora.dev/configuration) or the API so Panora knows where to deliver events.<br/>
+        Register the webhook endpoint’s accessible URL using the _Webhooks_ [section](https://app.panora.dev/configuration) or the API so Panora knows where to deliver events.<br/>
 
         **Webhook URL format** <br/>
 
@@ -89,7 +89,7 @@ It is a field of the [Connection Object](/glossary/connection-object) that Panor
 
         **Add a webhook endpoint** <br/>
 
-        Navigate to the _Configuration_ [section](https://dashboard.panora.dev/configuration) and head to the Webhooks tab. <br/>
+        Navigate to the _Configuration_ [section](https://app.panora.dev/configuration) and head to the Webhooks tab. <br/>
             <video
             controls
             className="w-full aspect-video"
@@ -105,7 +105,7 @@ It is a field of the [Connection Object](/glossary/connection-object) that Panor
         <CodeGroup>
         ```shell Curl
         curl --request POST \
-             --url https://api.panora.dev/webhook \
+             --url https://api.panora.dev/webhooks \
              --header 'x-api-key: <api-key>' \
              --header 'Content-Type: application/json' \
              --data '{
@@ -170,7 +170,7 @@ It is a field of the [Connection Object](/glossary/connection-object) that Panor
         }
 
         // Set your api key
-        // See your keys here: https://dashboard.panora.dev/api-keys
+        // See your keys here: https://app.panora.dev/api-keys
         const panora = new Panora({ apiKey: process.env.API_KEY });
 
         // Find your endpoint's secret in your webhook settings in the Config Page
@@ -240,7 +240,7 @@ It is a field of the [Connection Object](/glossary/connection-object) that Panor
         from django.views.decorators.http import require_http_methods
 
         # Set your api key
-        # See your keys here: https://dashboard.panora.dev/api-keys
+        # See your keys here: https://app.panora.dev/api-keys
         panora = Panora(api_key=os.getenv("API_KEY", ""))
 
         # Find your endpoint's secret in your webhook settings in the Config Page
diff --git a/docs/recipes/embed-catalog.mdx b/docs/recipes/embed-catalog.mdx
index ef8e7199b..2395e9454 100644
--- a/docs/recipes/embed-catalog.mdx
+++ b/docs/recipes/embed-catalog.mdx
@@ -81,4 +81,4 @@ Congrats ! You should be able to see the displayed connectors !
 
 You have the ability to choose which connectors will be rendered (also applied to magic-link).
 
-Go to _Manage Catalog Widget_ [section](https://dashboard.panora.dev/configuration), locate the connector you wish to add/remove and switch it on/off.
+Go to _Manage Catalog Widget_ [section](https://app.panora.dev/configuration), locate the connector you wish to add/remove and switch it on/off.
diff --git a/docs/recipes/import-existing-users.mdx b/docs/recipes/import-existing-users.mdx
index 92a7f28ee..bc56f64c2 100644
--- a/docs/recipes/import-existing-users.mdx
+++ b/docs/recipes/import-existing-users.mdx
@@ -39,24 +39,24 @@ These endpoint return [Linked Account object(s)](/glossary/linked-account-object
 <CodeGroup> 
  ```shell Import a single existing user
   curl --request POST \
-      --url https://api.panora.dev/linked-users \
+      --url https://api.panora.dev/linked_users \
       --header 'x-api-key: <api-key>' \
       --header 'Content-Type: application/json' \
       --data '{
           "linked_user_origin_id": "acme_user_1", # your remote id (id representing your existing user inside your system)
           "alias": "acme", # your company name
-          "id_project": "ikloqqkq90-djsddhjs-prs12dj",
+          "id_project": "ikloqqkq90-djsddhjs-prs12dj"
       }'
   ```
   ```shell Import a batch of existing users
   curl --request POST \
-      --url https://api.panora.dev/linked-users/batch \
+      --url https://api.panora.dev/linked_users/batch \
       --header 'x-api-key: <api-key>' \
       --header 'Content-Type: application/json' \
       --data '{
           "linked_user_origin_ids": ["acme_user_1", "acme_user_2", "acme_user_3"], # array of remote ids (ids representing your existing users inside your system)
           "alias": "acme", # your company name
-          "id_project": "ikloqqkq90-djsddhjs-prs12dj",
+          "id_project": "ikloqqkq90-djsddhjs-prs12dj"
       }'
   ```
 </CodeGroup>
@@ -75,12 +75,12 @@ At any point in your code, if you have successfully added your linked users (see
 <CodeGroup>
  ```shell linkedUserFromRemoteId
     curl --request GET \
-            --url https://api.panora.dev/linked-users/fromRemoteId?remoteId=acme_id_1 \
+            --url https://api.panora.dev/linked_users/fromRemoteId?remoteId=acme_id_1 \
             --header 'x-api-key: <api-key>' \
     ```
     ```shell fetchLinkedUsers
     curl --request GET \
-            --url https://api.panora.dev/linked-users \
+            --url https://api.panora.dev/linked_users \
             --header 'x-api-key: <api-key>' \
     ```
 </CodeGroup>
diff --git a/docs/webhooks/overview.mdx b/docs/webhooks/overview.mdx
index 1147cbfa7..d8eafb710 100644
--- a/docs/webhooks/overview.mdx
+++ b/docs/webhooks/overview.mdx
@@ -84,7 +84,7 @@ To enable webhook events, you need to register webhook endpoints. After you regi
         </CodeGroup>
     </Step>
     <Step title="Register your endpoint within Panora using the Dashboard or the API.">
-        Register the webhook endpoint’s accessible URL using the _Webhooks_ [section](https://dashboard.panora.dev/configuration) or the API so Panora knows where to deliver events.<br/>
+        Register the webhook endpoint’s accessible URL using the _Webhooks_ [section](https://app.panora.dev/configuration) or the API so Panora knows where to deliver events.<br/>
 
         **Webhook URL format** <br/>
 
@@ -96,7 +96,7 @@ To enable webhook events, you need to register webhook endpoints. After you regi
 
         **Add a webhook endpoint** <br/>
 
-        Navigate to the _Configuration_ [section](https://dashboard.panora.dev/configuration) and head to the Webhooks tab. <br/>
+        Navigate to the _Configuration_ [section](https://app.panora.dev/configuration) and head to the Webhooks tab. <br/>
         <video
         controls
         className="w-full aspect-video"
@@ -113,7 +113,7 @@ To enable webhook events, you need to register webhook endpoints. After you regi
         <CodeGroup>
         ```shell Curl
         curl --request POST \
-             --url https://api.panora.dev/webhook \
+             --url https://api.panora.dev/webhooks \
              --header 'x-api-key: <api-key>' \
              --header 'Content-Type: application/json' \
              --data '{
@@ -171,7 +171,7 @@ To enable webhook events, you need to register webhook endpoints. After you regi
         import { Panora } from '@panora/sdk';
 
         // Set your api key
-        // See your keys here: https://dashboard.panora.dev/api-keys
+        // See your keys here: https://app.panora.dev/api-keys
         const panora = new Panora({ apiKey: process.env.API_KEY });
 
         // Find your endpoint's secret in your webhook settings in the Config Page
@@ -232,7 +232,7 @@ To enable webhook events, you need to register webhook endpoints. After you regi
         from django.http import HttpResponse
 
         # Set your secret key.
-        # See your keys here: https://dashboard.panora.dev/api-keys
+        # See your keys here: https://app.panora.dev/api-keys
         panora = Panora(
             api_key=os.getenv("API_KEY", ""),
         )
diff --git a/packages/api/src/@core/linked-users/linked-users.controller.ts b/packages/api/src/@core/linked-users/linked-users.controller.ts
index 39028b300..a2c8dcdf6 100644
--- a/packages/api/src/@core/linked-users/linked-users.controller.ts
+++ b/packages/api/src/@core/linked-users/linked-users.controller.ts
@@ -42,6 +42,19 @@ export class LinkedUsersController {
     this.logger.setContext(LinkedUsersController.name);
   }
 
+  @ApiOperation({
+    operationId: 'remoteId',
+    summary: 'Retrieve a Linked User From A Remote Id',
+  })
+  @ApiQuery({ name: 'remoteId', example: 'id_1', required: true, type: String })
+  @ApiGetCustomResponse(LinkedUserResponse)
+  @UseGuards(ApiKeyAuthGuard)
+  @Get('fromRemoteId')
+  linkedUserFromRemoteId(@Query('remoteId') id: string) {
+    // validate project_id against user
+    return this.linkedUsersService.getLinkedUserV2(id);
+  }
+
   @ApiOperation({
     operationId: 'listLinkedUsers',
     summary: 'Retrieve Linked Users',
@@ -186,17 +199,4 @@ export class LinkedUsersController {
     // validate project_id against user
     return this.linkedUsersService.getLinkedUser(id);
   }
-
-  @ApiOperation({
-    operationId: 'remoteId',
-    summary: 'Retrieve a Linked User From A Remote Id',
-  })
-  @ApiQuery({ name: 'remoteId', example: 'id_1', required: true, type: String })
-  @ApiGetCustomResponse(LinkedUserResponse)
-  @UseGuards(ApiKeyAuthGuard)
-  @Get('fromRemoteId')
-  linkedUserFromRemoteId(@Query('remoteId') id: string) {
-    // validate project_id against user
-    return this.linkedUsersService.getLinkedUserV2(id);
-  }
 }
diff --git a/packages/api/src/@core/sync/sync.controller.ts b/packages/api/src/@core/sync/sync.controller.ts
index 2b12794b0..36814b768 100644
--- a/packages/api/src/@core/sync/sync.controller.ts
+++ b/packages/api/src/@core/sync/sync.controller.ts
@@ -164,7 +164,7 @@ export class SyncController {
   })
   @UseGuards(JwtAuthGuard)
   @ApiExcludeEndpoint()
-  @Post('internal/pull-frequencies')
+  @Post('internal/pull_frequencies')
   async updateInternalPullFrequency(
     @Request() req: any,
     @Body() data: UpdatePullFrequencyDto,
@@ -191,7 +191,7 @@ export class SyncController {
     description: 'Pull frequency updated successfully',
   })
   @UseGuards(ApiKeyAuthGuard)
-  @Post('pull-frequencies')
+  @Post('pull_frequencies')
   async updatePullFrequency(
     @Request() req: any,
     @Body() data: UpdatePullFrequencyDto,
@@ -216,7 +216,7 @@ export class SyncController {
   @ApiResponse({ status: 200, type: UpdatePullFrequencyDto })
   @UseGuards(JwtAuthGuard)
   @ApiExcludeEndpoint()
-  @Get('internal/pull-frequencies')
+  @Get('internal/pull_frequencies')
   async getInternalPullFrequency(@Request() req: any) {
     const projectId = req.user.id_project;
     const result = await this.syncService.getPullFrequency(projectId);
@@ -236,7 +236,7 @@ export class SyncController {
   })
   @ApiResponse({ status: 200, type: UpdatePullFrequencyDto })
   @UseGuards(ApiKeyAuthGuard)
-  @Get('pull-frequencies')
+  @Get('pull_frequencies')
   async getPullFrequency(@Request() req: any) {
     const projectId = req.user.id_project;
     const result = await this.syncService.getPullFrequency(projectId);
diff --git a/packages/api/swagger/swagger-spec.yaml b/packages/api/swagger/swagger-spec.yaml
index 0293916cf..02bedaae9 100644
--- a/packages/api/swagger/swagger-spec.yaml
+++ b/packages/api/swagger/swagger-spec.yaml
@@ -755,7 +755,7 @@ paths:
                 $ref: '#/components/schemas/ResyncStatusDto'
       tags: *ref_6
       x-speakeasy-group: sync
-  /sync/pull-frequencies:
+  /sync/pull_frequencies:
     post:
       operationId: updatePullFrequency
       summary: Update pull frequency for verticals
@@ -2127,6 +2127,27 @@ paths:
                 $ref: '#/components/schemas/UnifiedTicketingTeamOutput'
       tags: *ref_18
       x-speakeasy-group: ticketing.teams
+  /linked_users/fromRemoteId:
+    get:
+      operationId: remoteId
+      summary: Retrieve a Linked User From A Remote Id
+      parameters:
+        - name: remoteId
+          required: true
+          in: query
+          example: id_1
+          schema:
+            type: string
+      responses:
+        '200':
+          description: ''
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/LinkedUserResponse'
+      tags: &ref_19
+        - linkedUsers
+      x-speakeasy-group: linkedUsers
   /linked_users:
     post:
       operationId: createLinkedUser
@@ -2145,8 +2166,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/LinkedUserResponse'
-      tags: &ref_19
-        - linkedUsers
+      tags: *ref_19
       x-speakeasy-group: linkedUsers
     get:
       operationId: listLinkedUsers
@@ -2205,26 +2225,6 @@ paths:
                 $ref: '#/components/schemas/LinkedUserResponse'
       tags: *ref_19
       x-speakeasy-group: linkedUsers
-  /linked_users/fromRemoteId:
-    get:
-      operationId: remoteId
-      summary: Retrieve a Linked User From A Remote Id
-      parameters:
-        - name: remoteId
-          required: true
-          in: query
-          example: id_1
-          schema:
-            type: string
-      responses:
-        '200':
-          description: ''
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/LinkedUserResponse'
-      tags: *ref_19
-      x-speakeasy-group: linkedUsers
   /projects:
     get:
       operationId: getProjects