Skip to main content
POST
/
v1
/
tables
/
{table_id}
/
rows
Create Table Rows
curl --request POST \
  --url https://api.extruct.ai/v1/tables/{table_id}/rows \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "rows": [
    {
      "data": {},
      "metadata": {}
    }
  ],
  "run": false
}
'
[
  {
    "id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "parent_row_id": "<string>",
    "company_profile_id": "<string>",
    "data": {},
    "metadata": {},
    "parent_data": {}
  }
]

​
Overview

This endpoint adds rows to a table before or during enrichment workflows. Those rows can come from your own source or from earlier Extruct workflows. Each item in rows creates one row. Put row values inside data. On company tables, input is usually the main entry field and should hold the company’s official website domain or URL. On people tables, include the row fields required by the downstream columns you plan to run. Use run=false when you want to load or inspect rows first. Use run=true when new rows should immediately start table execution.

​
Example request

export EXTRUCT_API_TOKEN="YOUR_API_TOKEN"
export TABLE_ID="YOUR_TABLE_ID"

curl -X POST "https://api.extruct.ai/v1/tables/${TABLE_ID}/rows" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${EXTRUCT_API_TOKEN}" \
  -d '{
    "rows": [
      {"data": {"input": "https://stripe.com"}},
      {"data": {"input": "https://openai.com"}}
    ],
    "run": false
  }'

​
Key parameters

  • table_id (required): target table identifier.
  • rows (required): array of row objects; each row must include data.
  • run (optional): defaults to false; set true to trigger run after insert.

​
Success signal

A successful response returns created row metadata and IDs.

​
Common errors

​
401 Unauthorized

Check that your header is Authorization: Bearer ${EXTRUCT_API_TOKEN}.

​
404 Not Found

The table ID is invalid or unavailable in your workspace.

​
422 Unprocessable Entity

Most often caused by invalid rows shape or missing data.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
table_id
string
required

Body

application/json
​
rows
RowDataSchema · object[]
required
​
run
boolean
default:false

Response

Successful Response

​
id
string
required
​
created_at
string<date-time>
required

Row creation time.

​
parent_row_id
string | null

ID of the parent row, if any.

​
company_profile_id
string | null

ID of the linked company profile.

​
data
Data · object
​
metadata
object

Additional metadata

​
parent_data
object

Data from the parent row, if requested and available.