v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB
felix

Query Dataset

Execute Polars code on a dataset server-side.

The code runs in a sandboxed environment with access to:

  • df: Polars DataFrame containing the dataset
  • pl: Polars module for expressions

Assign the result to a result variable to return it. Multiline code is fully supported — use intermediate variables, comments, etc.

Security: Only allowlisted Polars DataFrame/Expression methods are permitted. Control-flow (for/while/if-stmt), comprehensions, f-strings, str.format, imports, eval/exec, and dunder access are all blocked.

Examples::

result = df.head(10)

filtered = df.filter(pl.col('score') > 0.5)
grouped = filtered.group_by('label').agg([
    pl.col('score').mean().alias('avg_score'),
    pl.col('score').count().alias('count')
])
result = grouped.sort('avg_score', descending=True)
post/felix/dataset/query

Request body

dataset_namestring required

Name of the dataset to query

versionstring nullable

Dataset version (latest if omitted)

codestring required

Polars code to execute. Access data as 'df'. Assign output to 'result'.

timeoutinteger

Execution timeout in seconds (1-120)

max_rows_returnedinteger

Maximum rows to return in result (1-100000)

Example request

{
  "code": "result = df.group_by('label').count()",
  "dataset_name": "my-sentiment-dataset"
}

Response

Successful Response

successboolean required
dataset_namestring required
dataset_versionstring required
{"stackTrail":"components:schemas:DatasetQueryResponse:properties:result","oasType":"schema","type":"unknown","title":"Result","description":"JSON-serializable query result"}
result_type'dataframe' | 'series' | 'scalar' | 'string' | 'list' | 'object' | 'none' required

Type of the returned result

row_countinteger nullable

Number of rows if result is a DataFrame

columnsstring[] nullable

Column names if result is a DataFrame

execution_time_msinteger required

Execution time in milliseconds

truncatedboolean

Whether result was truncated due to size limits

messagestring required