Update Dataset

Route

/v2/datasets/{id}

Description

Update an existing dataset with the provided configuration. The 'If-Match' header with the resource version can be optionally specified for concurrency control.

Method

PUT

Inputs

Parameter	Type	Required	Description
id	string	Yes	The unique identifier of the dataset to update
name	string	No	Human-readable name of the dataset
description	string	No	Detailed description of the dataset's purpose
sensitivity	string	Yes	Sensitivity level (unrestricted, low, moderate, high, critical)
domain	string	No	Domain category (corporate, partner, personal, public)
query	object	No	Query conditions that define dataset membership
backfills_enabled	boolean	No	Whether historical data processing is enabled
policy_ids	array[string]	No	List of policy IDs associated with this dataset

Headers

Header	Type	Required	Description
If-Match	string	No	Resource version for concurrency control

Request Body

{
  "name": "Updated Dataset Name",
  "description": "Updated description",
  "sensitivity": "high",
  "domain": "corporate",
  "backfills_enabled": false,
  "policy_ids": ["policy-123"]
}

Output

Field	Type	Description
type	string	Always "datasets"
size	integer	Number of datasets returned (always 1)
resources	array[Dataset]	Array containing the updated dataset
errors	array[Error]	Any errors encountered

Rate Limit

• 60 requests per minute per API key
• 5 concurrent requests per endpoint

Example Response

{
  "type": "datasets",
  "size": 1,
  "resources": [
    {
      "id": "dataset-123",
      "version": "v1.2.4",
      "name": "Updated Dataset Name",
      "description": "Updated description",
      "sensitivity": "high",
      "domain": "corporate",
      "created_at": "2024-01-15T10:30:00Z",
      "last_modified": "2024-01-25T16:45:00Z",
      "backfills_enabled": false,
      "policy_ids": ["policy-123"]
    }
  ],
  "errors": []
}