Skip to main content

Enhance a column

Use AI to generate or enrich values for a specific column across selected rows.
const rows = await client.tables.rows("tbl_abc123", { limit: 100 });

const job = await client.enhance.cells("tbl_abc123", {
  row_ids: rows.data.map((r) => r.id),
  column_key: "description",
  prompt: "Write a compelling product description based on the product name and specifications.",
  web_search: true,
});

console.log(job.id);                // "enhance_..."
console.log(job.status);            // "queued"
console.log(job.estimated_credits); // 84

Check enhancement progress

const status = await client.enhance.status("tbl_abc123");

for (const [column, stats] of Object.entries(status.columns)) {
  console.log(`${column}: ${stats.completed}/${stats.total} done`);
}

Enhance multiple columns at once

Enhance several columns of a single row in one request:
await client.enhance.bulk("tbl_abc123", {
  row_id: "row_xyz789",
  columns: [
    { key: "description", prompt: "Write a product description." },
    { key: "seo_title", prompt: "Generate an SEO-optimized title." },
    { key: "description_de", prompt: "Translate the description to German." },
  ],
});

Cancel enhancements

const result = await client.enhance.cancel("tbl_abc123");
console.log(result.cancelled_count);

Next

Export data

Export your data as JSON, CSV, XLSX, or images.