Skip to main content

​
DatasetRowsClient

adaline.datasets.rows works with individual rows inside a dataset — list them, add new ones in batch, patch a single row’s cell values, or delete a row. Every method is async.

​
Access

from adaline.main import Adaline

adaline = Adaline()
rows = adaline.datasets.rows  # DatasetRowsClient
The class is also exported directly: 
from adaline.clients import DatasetRowsClient
Types from adaline_api: 
from adaline_api.models.dataset_row import DatasetRow
from adaline_api.models.dataset_row_input import DatasetRowInput
from adaline_api.models.add_dataset_rows_response import AddDatasetRowsResponse
from adaline_api.models.list_dataset_rows_response import ListDatasetRowsResponse

​
list()

List rows in a dataset (paginated). 
async def list(
    *,
    dataset_id: str,
    columns: Optional[str] = None,
    sort: Optional[SortOrderInput] = None,
    created_after: Optional[int] = None,
    created_before: Optional[int] = None,
    limit: Optional[int] = None,
    cursor: Optional[str] = None,
) -> ListDatasetRowsResponse

​
Parameters

NameTypeRequiredDescription
dataset_idstrYesDataset identifier.
columnsOptional[str]NoComma-separated column IDs or names. Omit to return all.
sortOptional[SortOrderInput]NoSort order.
created_after / created_beforeOptional[int]NoUnix millisecond bounds.
limitOptional[int]NoPage size (default 50, max 200).
cursorOptional[str]NoCursor from a previous response.

​
Returns

ListDatasetRowsResponse with { data: list[DatasetRow]; pagination: Pagination }.

​
Example

response = await adaline.datasets.rows.list(
    dataset_id="dataset_abc123",
    columns="question,expected",
    sort="createdAt:desc",
    limit=100,
)

​
create()

Create one or more rows in a single batch (up to 100). 
async def create(
    *,
    dataset_id: str,
    rows: List[DatasetRowInput],
    values_by: Optional[str] = None,  # "columnId" or "columnName"
) -> AddDatasetRowsResponse

​
Parameters

NameTypeRequiredDescription
dataset_idstrYesDataset identifier.
rowsList[DatasetRowInput]YesRow definitions, each with a values map.
values_byOptional[str]No"columnId" (default) or "columnName".

​
Returns

AddDatasetRowsResponse with { rows: list[DatasetRow] }.

​
Example

from adaline_api.models.dataset_row_input import DatasetRowInput

response = await adaline.datasets.rows.create(
    dataset_id="dataset_abc123",
    values_by="columnName",
    rows=[
        DatasetRowInput(values={"question": "How do I reset my password?", "expected": "Link to reset"}),
        DatasetRowInput(values={"question": "How do I cancel my plan?", "expected": "Link to billing"}),
    ],
)

print(f"Inserted {len(response.rows)} rows")

​
update()

Update the cell values on a single row. Cell values you don’t include are left untouched. 
async def update(
    *,
    dataset_id: str,
    row_id: str,
    row: DatasetRowInput,
    values_by: Optional[str] = None,
) -> DatasetRow

​
Example

from adaline_api.models.dataset_row_input import DatasetRowInput

await adaline.datasets.rows.update(
    dataset_id="dataset_abc123",
    row_id="row_def456",
    values_by="columnName",
    row=DatasetRowInput(values={"expected": "Updated expected answer"}),
)

​
delete()

Delete a single row from a dataset. 
async def delete(*, dataset_id: str, row_id: str) -> None

​
See Also