POST
/
api
/
ai
/
table
/
{ai_table_id}
/
run
curl --request POST \
  --url https://cite.petal.org/api/ai/table/{ai_table_id}/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "continue_response": true,
  "doc_id_col_id": [
    [
      123
    ]
  ]
}'
[
  {
    "ai_column_id": 123,
    "document_id": 123,
    "id": 123,
    "meta": {},
    "modified_at": "<string>",
    "response": "<string>",
    "task_id": "<string>",
    "task_status": "<string>"
  }
]

Authorizations

Authorization
string
header
required

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

Path Parameters

ai_table_id
integer
required

The unique ID of the AI Table

Body

application/json
doc_id_col_id
array
required

List of Document-column pairs to create cells for, or to re-generate AI responses for. Provide the Document ID as the first item, then the AI column ID as the second item, for each pair

continue_response
boolean

Whether the AI should continue the existing response found within the cell. Do not use on empty cells

Response

200
application/json
OK
ai_column_id
integer
required

The unique ID of the column the cell belongs to

document_id
integer
required

The unique ID of the Document associated with the cell

id
integer
required

The unique ID of the cell

meta
object
required

Metadata, for internal use

modified_at
string
required

Modification time, by UTC

response
string
required

The AI's response to the user based on the column query of this cell, or a user-submitted response

task_id
string
required

Task ID for internal use

task_status
string
required

AI task status for this cell