create-dataset
WHEN TO USE:
- When setting up a new data structure from scratch
- When you need to store a new type of data with specific validation rules
- When creating companion datasets
- When separating data into different logical collections
- When you need to enforce specific data types and mandatory fields
Tool Description:
Creates a new dataset with defined schema and validation rules in a specified workspace.
Required parameters:
- accountId: Target account ID
- workspaceId: Target workspace ID
- name: Dataset name (must be unique)
- targetFields: Array of field definitions
Each targetField must have:
- name: Field identifier (e.g., "customer_id")
- type: One of ["string", "number", "integer", "date"]
- mandatory: Boolean indicating if field is required
- Optional: isKeyComponent (boolean), description (string)
Example usage:
Creating a customer dataset:
{
"accountId": 123,
"workspaceId": 123,
"name": "Customer_Database",
"description": "Customer information tracking system",
"targetFields": [
{
"name": "customer_id",
"type": "string",
"mandatory": true,
"isKeyComponent": true,
"description": "Unique customer identifier"
},
{
"name": "join_date",
"type": "date",
"mandatory": true
}
]
}
