Skip to main content
POST
Suggest example rows to train on

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

saved_agent_id
string<uuid>
required

Body

application/json

A request for example rows to fill the training grid with.

count
integer
default:5

How many examples to offer.

Required range: 1 <= x <= 25
regenerate
boolean
default:false

Skip the agent's remembered examples and find fresh ones, replacing what was stored. What 'Suggest different examples' asks for; the default replays the set so training the same agent twice offers the same rows.

Response

Successful Response

Example rows to fill the grid with, and where they came from.

origin
enum<string>
required

How the values were found: read out of one of the org's own tables, or written by the model.

Available options:
table,
generated
rows
Rows · object[]
required

One set of input values per example, in offer order.

inputs_changed
boolean
default:false

A remembered set was discarded because the agent's inputs no longer matched it, so these are fresh.

remembered
boolean
default:false

These were replayed from the agent rather than found afresh.

table_name
string | null

The table the values came from; null when they were generated.