Feat(public-dashboard): Feb release-Update document for Public dashboard GA

src/content/docs/apis/nerdgraph/examples/manage-live-chart-urls-via-api.mdx

@@ -1,5 +1,5 @@
 ---
-title: "NerdGraph tutorial: List and revoke live chart URLs"
+title: "NerdGraph tutorial: List and revoke public sharing chart URLs"
 tags:
   - APIs
   - NerdGraph
@@ -10,14 +10,14 @@ freshnessValidatedDate: never
 
 You can list and revoke publicly accessible live chart URLs using queries and mutations in [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph).
 
-To do so:
+To do this:
 
-1. Go to the [GraphiQL explorer](https://api.newrelic.com/graphiql).
+1. Go to [GraphiQL Explorer](https://api.newrelic.com/graphiql).
 2. [List all live chart URLs](#list) created within your New Relic account.
 3. [Revoke any live chart URL you want to](#revoke).
 
 <Callout variant="tip">
-  See our docs [to create public live charts](/docs/query-your-data/explore-query-data/dashboards/manage-your-dashboard/#export-share).
+  To create publicly accessible live chart URLs, refer our [docs](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#chart).
 </Callout>
 
 ## List all live chart URLs [#list]

src/content/docs/apis/nerdgraph/examples/manage-live-dashboard-urls-via-api.mdx

@@ -0,0 +1,156 @@
+---
+title: "NerdGraph tutorial: Create, update, and revoke public sharing dashboard URLs"
+tags:
+  - share dashboards externally
+  - share dashboards using NerdGraph
+  - public dashboard
+  - public dashboard URL
+metaDescription: Use New Relic NerdGraph to create, update, and revoke live dashboard URLs
+freshnessValidatedDate: never
+---
+
+With the necessary [security and access set up](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts) you can create, manage, and revoke publicly accessible live dashboard URLs using queries and mutations in [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph), 
+You can also do it from the [New Relic UI](/docs/query-your-data/explore-query-data/dashboards/share-charts-dashboards-externally/#dashboard).
+
+<Callout variant="caution">
+  Anyone with the live dashboard or chart URLs can view all the information from the dashboard. Share information carefully and in accordance with your company's internal policies and procedures.
+</Callout>
+
+For creating, updating, or revoking a publicly accessible live dashboard URL from NerdGraph, you need the GUID of the dashboard you want to share.
+
+1. Go to <DNT>**[one.newrelic.com > Dashboards](https://one.newrelic.com//dashboards)**</DNT>.
+2. Open the dashboard you want to share.
+3. Navigate to <DNT>**<Icon name="fe-more-horizontal"/> > Metadata**</DNT>, and copy the entity GUID of the dasboard.
+
+<CollapserGroup>
+<Collapser id="create-dashboard-url-nerdgraph" title="Create a live dashboard URL">
+1. Go to [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql).
+2. Construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) using the following details:
+  * **Mutation**: `dashboardCreateLiveUrl`
+  * **GUID**: The entity guide of the dashboard
+  * **Options**(optional): The time period in seconds for the URL to be live
+      * **Minimum value**: 300 seconds (5 minutes)
+      * **Maximum value**: 631152000 seconds (20 years)
+      * **Default value**: 2592000 seconds (30 days)
+  * **Response**: `url`
+
+  ```
+  mutation CreatePublicLink {
+    dashboardCreateLiveUrl(
+      guid: "enter the dashboard GUID"
+      options: { ttl: "updated duration in seconds" }
+    ) {
+      url
+    }
+  }
+
+  ```
+The live dashboard URL appears in the response. This is a public URL, so you can share it with anyone.
+
+  ```
+  https://share.newrelic.com/dashboard/<public_link_id>
+
+  ```
+The `<public_link_id>` is the ID of the shared dashboard. You can use it to update or revoke the shared dashboard URL through NerdGraph.
+
+<Callout variant="important">
+  Any content update in the dashboard on New Relic platform reflects in the shared dashboard page.
+</Callout>
+
+</Collapser>
+
+<Collapser id="update-dashboard-url-nerdgraph" title="Update a live dashboard URL">
+Make sure you have the [permissions](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts/#permissions-to-custom-role) to modify the configuration of the shared dashboard. 
+
+To update the time period for the URL to be live:
+1. Go to [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql).
+2. Construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) using the following details:
+  * **Mutation**: `dashboardUpdateLiveUrl`
+  * **ID**: The ID of the shared dashboard (Copy it from the shared dashboard URL.)
+  * **Options**: The updated time period in seconds
+      * **Minimum value**: 300 seconds (5 minutes)
+      * **Maximum value**: 631152000 seconds (20 years)
+      * **Default value**: 2592000 seconds (30 days)
+
+  ```
+  mutation UpdatePublicLink{
+        dashboardUpdateLiveUrl(
+          id:"enter the public link ID"
+          options: { ttl: "updated duration in seconds" }
+        ) {
+          title
+          url
+        }
+  }
+
+  ```
+The URL appears in the response as follows. Now the URL will remain live for the updated time period.
+
+  ```
+  https://share.newrelic.com/dashboard/<public_link_id>
+
+  ```
+
+</Collapser>
+
+<Collapser id="revoke-dashboard-url-nerdgraph" title="Revoke a live dashboard URL">
+Based on the [permissions](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts/#permissions-to-custom-role) you have, you can revoke only the URLs you have created, or all URLs created by users in the account. To revoke a shared dashboard URL:
+1. Go to [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql).
+2. Construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) using the following details:
+  * **Mutation**: `dashboardRevokeLiveUrl`
+  * **ID**: The ID of the shared dashboard (Copy it from the shared dashboard URL.)
+
+  ```
+  mutation {
+    dashboardRevokeLiveUrl(id: "<public_link_id>") {
+      id
+    }
+  }
+
+  ```
+The shared dashboard URL is now revoked, and it will no longer be accessible. The response appears as follows:
+
+  ```
+  {
+    "data": {
+      "dashboardRevokeLiveUrl": {
+        "id": "<public_link_id>" //the one you passed to the mutation
+      }
+    }
+  }
+
+  ```
+</Collapser>
+
+<Collapser id="list-dashboard-url-nerdgraph" title="List all shared dashboard URLs">
+Based on the [permissions](/docs/query-your-data/explore-query-data/dashboards/prerequisites-to-share-dashboards-charts/#permissions-to-custom-role) you have, you can retrieve the list of links you have created, or all links created by users in the account. To get the list of shared dashboard URLs:
+1. Go to [NerdGraph API explorer](https://one.newrelic.com/nerdgraph-graphiql).
+2. Construct a [graph API call](/docs/apis/nerdgraph/get-started/nerdgraph-explorer) using the following details:
+  * **Query**: `dashboard`
+  * **Response**: `liveUrls`
+
+  ```
+  {
+      actor {
+        user {
+          name
+        }
+          dashboard {
+          liveUrls(filter: {type: DASHBOARD}) {
+            liveUrls {
+              createdAt
+              type
+              uuid
+            }
+          }
+        }
+      }
+    }
+
+  ```
+
+  The list of the shared dashboard URLs appears in response.
+</Collapser>
+
+
+</CollapserGroup>

src/content/docs/apis/nerdgraph/examples/nerdgraph-dashboards.mdx

@@ -248,6 +248,63 @@ Here are operations related to creating, reading, updating, and deleting (CRUD).
         Revoke widget live URL operation. You can revoke a previously created live URL of a widget. As a result, the live URL will become unavailable to the public.
       </td>
     </tr>
+
+    <tr>
+      <td>
+        `dashboardCreateLiveUrl()`
+      </td>
+
+      <td>
+        mutation
+      </td>
+
+      <td>
+        Create publicly accessible live dashboard URL.
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        `dashboardUpdateLiveUrl()`
+      </td>
+
+      <td>
+        mutation
+      </td>
+
+      <td>
+        Update the expiration date of a publicly accessible live dashboard URL.
+      </td>
+    </tr>    
+
+    <tr>
+      <td>
+        `dashboardRevokeLiveUrl()`
+      </td>
+
+      <td>
+        mutation
+      </td>
+
+      <td>
+        Revoke publicly accessible live dashboard URL.
+      </td>
+      </tr>
+
+    <tr>
+      <td>
+        `dashboardUpdateLiveUrlCreationPolicies()`
+      </td>
+
+      <td>
+        mutation
+      </td>
+
+      <td>
+        Only an Authentication Domain Manager can use this mutation to enable or disable the <DNT>**Live URL Creation**</DNT> policy for accounts. Users can create live URLs for dashboards in accounts where this policy is enabled.
+      </td>
+      </tr>      
+
   </tbody>
 </table>
 

src/content/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph.mdx

@@ -139,7 +139,7 @@ Here are all our available NerdGraph docs:
 
       <td>
         * [Install browser agent and configure monitoring](/docs/apis/nerdgraph/examples/browser-monitoring-config-nerdgraph)
-        * [Instrument multiple apps using npm package](/docs/apis/nerdgraph/examples/combining-npm-nerdgraph)
+        * [Instrument multiple apps using NPM package](/docs/apis/nerdgraph/examples/combining-npm-nerdgraph)
       </td>
     </tr>
 
@@ -164,7 +164,8 @@ Here are all our available NerdGraph docs:
         * [Dashboards: charts and widgets](/docs/apis/nerdgraph/examples/create-widgets-dashboards-api)
         * [Export dashboards to other accounts](/docs/apis/nerdgraph/examples/export-import-dashboards-using-api/)
         * [Export dashboards as files](/docs/apis/nerdgraph/examples/export-dashboards-pdfpng-using-api/)
-        * [Manage externally shared dashboards](/docs/apis/nerdgraph/examples/manage-live-chart-urls-via-api)
+        * [Manage externally shared dashboards](/docs/apis/nerdgraph/examples/manage-live-dashboard-urls-via-api)
+        * [Manage externally shared charts](/docs/apis/nerdgraph/examples/manage-live-chart-urls-via-api)       
       </td>
     </tr>