Schema introspection
Every command below with arguments supports two read-only flags for tooling and AI agents:--show-file-schema: print the JSON Schema for the full request object (the format--filenameaccepts).--show-argument-schema <flag-name>: print the JSON Schema for one argument’s value. Pass the kebab flag name without the leading--(e.g.datapoint-ids, not--datapoint-ids).
list
Retrieve a list of datapoints
Retrieve datapoints, optionally filtered by a list of datapoint IDs or dataset name.
Usage
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--datapoint-ids | json | no | List of datapoint ids to fetch |
--dataset-name | string | no | Name of the dataset to get datapoints from |
--show-file-schema, --show-argument-schema <flag-name>, and --filename. See Schema introspection for details.
create
Create a new datapoint
Create a single datapoint with inputs, history, ground truth, and metadata.
Usage
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--ground-truth | json | no | ground_truth |
--history | json | no | history |
--inputs | json | no | inputs |
--linked-datasets | json | no | linked_datasets |
--linked-event | string | no | linked_event |
--metadata | json | no | metadata |
--show-file-schema, --show-argument-schema <flag-name>, and --filename. See Schema introspection for details.
create-batch
Create multiple datapoints in batch
Create multiple datapoints from events using field mappings and optional filters.
Usage
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--check-state | json | no | checkState |
--dataset-id | string | no | dataset_id |
--date-range | json | no | dateRange |
--events | json | no | events |
--filters | json | no | filters |
--mapping | json | no | mapping |
--select-all / --no-select-all | boolean | no | selectAll |
--show-file-schema, --show-argument-schema <flag-name>, and --filename. See Schema introspection for details.
get
Retrieve a specific datapoint
Get a single datapoint by its unique identifier.
Usage
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--datapoint-id | string | yes | Datapoint ID like 65c13dbbd65fb876b7886cdb |
--show-file-schema, --show-argument-schema <flag-name>, and --filename. See Schema introspection for details.
update
Update a specific datapoint
Update fields on an existing datapoint. Only the provided fields are modified.
Usage
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--datapoint-id | string | yes | ID of datapoint to update |
--ground-truth | json | no | ground_truth |
--history | json | no | history |
--inputs | json | no | inputs |
--linked-datasets | json | no | linked_datasets |
--linked-event | string | no | linked_event |
--metadata | json | no | metadata |
--show-file-schema, --show-argument-schema <flag-name>, and --filename. See Schema introspection for details.
delete
Delete a specific datapoint
Permanently delete a datapoint by its unique identifier.
Usage
Options
| Flag | Type | Required | Description |
|---|---|---|---|
--datapoint-id | string | yes | Datapoint ID like 65c13dbbd65fb876b7886cdb |
--show-file-schema, --show-argument-schema <flag-name>, and --filename. See Schema introspection for details.