Add more information on snapshots (#2899)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-06-06 17:43:33.552338",
-            "spec_repo_commit": "01341d5b"
+            "regenerated": "2025-06-09 14:45:35.688547",
+            "spec_repo_commit": "79e7c933"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-06-06 17:43:33.567997",
-            "spec_repo_commit": "01341d5b"
+            "regenerated": "2025-06-09 14:45:35.704920",
+            "spec_repo_commit": "79e7c933"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -26423,7 +26423,10 @@ paths:
         - events_read
   /api/v1/graph/snapshot:
     get:
-      description: 'Take graph snapshots.
+      description: 'Take graph snapshots. Snapshots are PNG images generated by rendering
+        a specified widget in a web page and capturing it once the data is available.
+        The image is then uploaded to cloud storage.
+
 
         **Note**: When a snapshot is created, there is some delay before it is available.'
       operationId: GetGraphSnapshot

src/main/java/com/datadog/api/client/v1/api/SnapshotsApi.java

@@ -194,8 +194,12 @@ public CompletableFuture<GraphSnapshot> getGraphSnapshotAsync(
   }
 
   /**
-   * Take graph snapshots. <strong>Note</strong>: When a snapshot is created, there is some delay
-   * before it is available.
+   * Take graph snapshots. Snapshots are PNG images generated by rendering a specified widget in a
+   * web page and capturing it once the data is available. The image is then uploaded to cloud
+   * storage.
+   *
+   * <p><strong>Note</strong>: When a snapshot is created, there is some delay before it is
+   * available.
    *
    * @param start The POSIX timestamp of the start of the query in seconds. (required)
    * @param end The POSIX timestamp of the end of the query in seconds. (required)