Create dataset example

Create one dataset example from JSON fields. Use dataset import for archive-based uploads and file-bearing examples.

idstring required

Automation id or typed alias, such as workflows.slug or agents.slug.

Request body

namestring nullable

Example name. Required on create; omitted or null uses a generated name where supported.

inputobject nullable

Input arguments for the example.

{"stackTrail":"components:schemas:DatasetExampleMutation:properties:expected:anyOf","oasType":"schema","type":"unknown","description":"Expected JSON output. Null clears the expected output.","nullable":true}

metadataobject nullable

Caller-managed metadata.

annotationstring nullable

Human note about the example. Null clears the annotation.

rowOrderinteger nullable

Optional display order. Null clears the order.

overridesobject nullable

Step output overrides used during example runs.

Response

Created dataset example.

idstring required

Stable public example id. Workflow examples use DB ids; agent examples use deterministic name-derived ids.

namestring required

Human-readable dataset example name.

automationIdstring required

Automation that owns this example.

automationType'workflow' | 'agent' required

inputobject nullable required

Input arguments used when this example is run.

{"stackTrail":"components:schemas:DatasetExample:properties:expected:anyOf","oasType":"schema","type":"unknown","description":"Expected JSON output for evaluator comparisons.","nullable":true}

metadataobject nullable required

Caller-managed metadata for sorting or filtering examples.

annotationstring nullable required

Human note about the example.

rowOrdernumber nullable required

Optional display order within the dataset.

overridesobject nullable required

Step output overrides used when running this example.

latestRunIdstring nullable required

Most recent run id created from this example.

v1

Create dataset example

Path parameters

Request body

Response