Add Dataset

Route

/v2/datasets

Description

Create a new dataset with the provided configuration. Datasets define collections of data for classification and protection policies.

Method

POST

Inputs

Parameter	Type	Required	Description
name	string	Yes	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

Request Body

{
  "name": "Financial Records",
  "description": "Sensitive financial data and records",
  "sensitivity": "critical",
  "domain": "corporate",
  "query": {
    "rules": [
      {
        "conditions": [
          {
            "field_name": "content_tags",
            "operator": "has_tag",
            "values": [{"value": "financial"}]
          }
        ]
      }
    ]
  },
  "backfills_enabled": true,
  "policy_ids": ["policy-456"]
}

Output

Field	Type	Description
type	string	Always "datasets"
size	integer	Number of datasets returned (always 1)
resources	array[Dataset]	Array containing the created 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-789",
      "name": "Financial Records",
      "description": "Sensitive financial data and records",
      "sensitivity": "critical",
      "domain": "corporate",
      "created_at": "2024-01-15T10:30:00Z",
      "backfills_enabled": true,
      "policy_ids": ["policy-456"]
    }
  ],
  "errors": []
}