​
Overview

Add new columns to an existing experiment dataset structure.

​
Method Signature

# Synchronous
client.experiments.add_columns(
    experiment_id: str,
    columns: List[Dict[str, Any]]
) -> Dict[str, Any]

# Asynchronous
await client.experiments.add_columns(
    experiment_id: str,
    columns: List[Dict[str, Any]]
) -> Dict[str, Any]

​
Parameters

​
experiment_id
string
required
The unique identifier of the experiment
​
columns
List[Dict[str, Any]]
required
List of column definitions to add to the experiment

​
Returns

Returns a dictionary containing the updated experiment information.

​
Example

from keywordsai import KeywordsAI

client = KeywordsAI(api_key="your-api-key")

# Add new columns to experiment
columns = [
    {
        "name": "confidence_score",
        "type": "float",
        "description": "Model confidence level"
    },
    {
        "name": "category",
        "type": "string",
        "description": "Response category"
    }
]

result = client.experiments.add_columns(
    experiment_id="exp_123",
    columns=columns
)

print(f"Added {len(columns)} columns to experiment")

​
Error Handling

try:
    result = client.experiments.add_columns(
        experiment_id="exp_123",
        columns=columns
    )
except Exception as e:
    print(f"Error adding columns: {e}")