Add more information on snapshots (#2607)

Co-authored-by: ci.datadog-api-spec <[email protected]>

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:35.755139",
-            "spec_repo_commit": "01341d5b"
+            "regenerated": "2025-06-09 14:45:37.430557",
+            "spec_repo_commit": "79e7c933"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-06-06 17:43:35.770681",
-            "spec_repo_commit": "01341d5b"
+            "regenerated": "2025-06-09 14:45:37.519358",
+            "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/datadog_api_client/v1/api/snapshots_api.py

@@ -97,7 +97,8 @@ def get_graph_snapshot(
     ) -> GraphSnapshot:
         """Take graph snapshots.
 
-        Take graph snapshots.
+        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.
 
         :param start: The POSIX timestamp of the start of the query in seconds.