Skip to main content
POST
Rate many cells at once

Authorizations

Authorization
string
header
required

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

Path Parameters

table_id
string<uuid>
required

Body

application/json

One verdict, applied to many cells.

The rating and the note are shared on purpose: a swept selection is one judgement about one thing the column got wrong, so asking for the sentence N times would collect N copies of it.

cells
CellFeedbackTargetSchema · object[]
required

The cells to rate.

Required array length: 1 - 1000 elements
rating
enum<string>
required

How a person judged one produced cell value.

Available options:
up,
down
comment
string | null

What was wrong, in the user's own words. Applied to every named cell. Optional.

Maximum string length: 2000

Response

Successful Response

Result of a bulk rating; cells that could not be rated are counted.

No echo of the stored verdicts: the caller already knows the one rating and one note it sent, so returning a thousand identical copies would say nothing it could not derive. skipped_column_ids is the part it cannot.

applied
integer
required

Cells whose verdict was written.

skipped
integer
required

Cells refused because their column runs no saved agent to improve.

skipped_column_ids
string<uuid>[]

The distinct columns that refused, so the client can name them.