Skip to main content
POST
Give a thumbs down

Authorizations

X-API-Key
string
header
required

Body

application/json

A thumbs down: what was wrong with something an agent wrote.

reason
string
required

What is wrong, in the person's words. Required.

Maximum string length: 1000
request_id
string<uuid>
required

The client's key for this thumbs down: sent again (a double click, a retry), it answers what the first one did and writes nothing.

subject
TableCellsSubjectSchema · object
required

Cells of one agent column.

Response

Successful Response

What a thumbs down did.

action
enum<string>
required

added a learning, or updated one about the same thing.

Available options:
added,
updated,
split,
carried,
skipped,
seeded
agent_name
string
required

The agent that learned it.

event_id
string<uuid>
required

The thumbs down, for Undo.

learning
AgentLearningReadSchema · object | null
required

The learning as written; null on a replay whose learning was deleted since.

previous_text
string | null
required

What the updated learning said before; null for an added one.

redo
RedoReadSchema · object
required

How the redo a thumbs down asked for went.

subject_key
string
required

What the thumbs down was given on, as list_thumbs_downs takes it, so a screen that gave it elsewhere (the AI Assistant's card) can follow its note.