Skip to main content
PATCH
Change a proposed learning

Authorizations

X-API-Key
string
header
required

Path Parameters

event_id
string<uuid>
required

Body

application/json

Change a proposed learning's words or scope before it is saved.

scope
enum<string> | null

sequence or account. Switching a learning that names one step to account rewords it to name none.

Available options:
sequence,
account
text
string | null

The person's own words for it.

Required string length: 1 - 300

Response

Successful Response

One thumbs down, as the note in place shows it.

action
enum<string>
required

What one event did to an agent's learnings.

Available options:
added,
updated,
split,
carried,
skipped,
seeded
agent_name
string
required
created_at
string<date-time>
required
id
string<uuid>
required
redo_detail
string | null
required
redo_state
enum<string>
required

How the redo a thumbs down asked for went.

Available options:
none,
started,
written,
refused
restore
enum<string>
required

Where putting the original output back stands after Undo: none, waiting, restored or left.

Available options:
none,
waiting,
restored,
left
restore_detail
string | null
required

Why the original was left as the redo left it.

status
enum<string>
required

applied (its learning is saved), undone after Undo, proposed while an outbound thumbs down's learning waits for a person (Will learn), dismissed once that one was thrown away (Undo, a rejection, a discard, or a week unsaved).

Available options:
applied,
undone,
proposed,
dismissed
subject_key
string
required

What it was given on, as subject_key names it: a read of several subjects at once sorts its thumbs downs back to each by this.

text_after
string | null
required

The learning as the thumbs down wrote it.

text_before
string | null
required

What an updated learning said before.

proposal
ProposalReadSchema · object | null

The learning an outbound thumbs down proposed; null for a table agent's.

record_ids
string<uuid>[]

The rows a thumbs down on cells covered, so the grid shows its note on each; empty on every other surface.

saved_agent_id
string<uuid> | null

The saved agent the thumbs down was given to (for an outbound one, its sequence's writer, whose learnings a full list's "replace one" picks from); null for an unlinked column's.

would_have_written
WouldHaveWrittenReadSchema · object | null

On a sent message: what the agent would have sent instead, once written (redo_state written); null before then and on every other surface.