Add more information on snapshots (#3136)

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:36.739470",
-            "spec_repo_commit": "01341d5b"
+            "regenerated": "2025-06-09 14:45:35.094004",
+            "spec_repo_commit": "79e7c933"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-06-06 17:43:36.757088",
-            "spec_repo_commit": "01341d5b"
+            "regenerated": "2025-06-09 14:45:35.109811",
+            "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

api/datadogV1/api_snapshots.go

@@ -68,7 +68,8 @@ func (r *GetGraphSnapshotOptionalParameters) WithWidth(width int64) *GetGraphSna
 }
 
 // GetGraphSnapshot 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.
 func (a *SnapshotsApi) GetGraphSnapshot(ctx _context.Context, start int64, end int64, o ...GetGraphSnapshotOptionalParameters) (GraphSnapshot, *_nethttp.Response, error) {
 	var (