Skip to main content
GET
List AI Assistant column suggestions

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

Query Parameters

status
enum<string> | null

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
conversation_id
string<uuid> | null

Response

Successful Response

A table's proposed columns.

suggestions
AssistantSuggestionReadSchema · object[]
required
total_count
integer
required