Skip to main content
POST
Dismiss an AI Assistant column suggestion

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
suggestion_id
string<uuid>
required

Body

application/json

Take a suggestion off the table.

reason
string | null
Maximum string length: 500

Response

Successful Response

One proposed column, as its card renders it.

The credit figures are per-row and for the two batch sizes the card offers, computed server-side so the card never does credit arithmetic of its own.

accepted_column_id
string<uuid> | null
required
action_key
string | null
required
column_type
string | null
required
conversation_id
string<uuid>
required
created_at
string<date-time>
required
credit_tenths_per_row
integer
required
description
string | null
required
dismissed_reason
string | null
required
display_name
string
required
id
string<uuid>
required
kind
string
required
message_id
string<uuid>
required
position
integer
required
rationale
string | null
required
status
enum<string>
required

Where a proposed column stands.

Note what is absent: previewing ("try on N rows") is NOT a transition. It creates nothing, so the suggestion is still on offer afterwards, and a status that moved on a preview would take the offer away from a user who had only just started evaluating it.

SUPERSEDED exists because a follow-up turn re-proposing the same column would otherwise leave two near-identical cards on screen, and the user accepts whichever they happen to click — which is as likely to be the one they asked to change as the one they asked for.

Available options:
pending,
accepted,
dismissed,
superseded
table_id
string<uuid>
required