v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Security Monitoring

Get a dataset at a specific version

Retrieve a specific historical version of a Cloud SIEM dataset.

get/api/v2/security_monitoring/datasets/{dataset_id}/version/{version}

Path parameters

dataset_idstring required

Example:123e4567-e89b-12d3-a456-426614174000

The UUID of the dataset.

versioninteger required

Example:1

The version number of the dataset to retrieve.

Response

Example response

{
  "data": {
    "attributes": {
      "createdAt": "2025-03-20T10:00:00Z",
      "createdByHandle": "bruce.lee",
      "createdByName": "Bruce Lee",
      "definition": {
        "columns": [
          {
            "column": "message",
            "type": "string"
          }
        ],
        "data_source": "logs",
        "name": "sample_dataset",
        "query_filter": "status = 'active'",
        "search": {
          "query": "*"
        },
        "storage": "hot",
        "table_name": "my_reference_table",
        "time_window": {
          "from": 1700000000000,
          "to": 1700003600000
        }
      },
      "description": "A sample dataset used for detection rules.",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "modifiedAt": "2025-03-20T10:00:00Z",
      "name": "sample_dataset",
      "updatedByHandle": "bruce.lee",
      "updatedByName": "Bruce Lee",
      "version": 1
    },
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "type": "dataset"
  }
}