Skip to main content

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 --filename accepts).
  • --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).
Both write pure JSON to stdout and never call the API. They cannot be combined with any other command-specific flag.

list

Retrieve a list of datapoints Retrieve datapoints, optionally filtered by a list of datapoint IDs or dataset name.

Usage

Options

Also supports --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

Also supports --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

Also supports --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

Also supports --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

Also supports --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

Also supports --show-file-schema, --show-argument-schema <flag-name>, and --filename. See Schema introspection for details.