Tables

Change rows

rows_update · Changes data · Markdown

Changes values in up to 500 rows by row number; only the columns given change, and null clears a cell.

$0.001 per row changed

From your agent’s balance. A call that fails costs nothing.

An example

Rachel's bike is finished. Mark it ready in the workshop table.

Your agent callsrows_update$0.001 per row changed

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "table": "Workshop jobs",
  "rows": [
    {
      "row": 1,
      "values": {
        "Status": "Ready"
      }
    }
  ]
}
What comes back
{
  "changed": 1
}

Use it when

Something about a record changed: a status, a date, a price.

What it does

Change values in up to 500 rows by their row number: [{"row": 12, "values": {"Stage": "Ordered"}}]. A null value clears a cell. Only the columns given change.

What comes back

changed: how many rows changed. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
tableRequiredstringThe table's name (or its table_id). 1 to 80 characters.
rowsRequiredarray of objects1 to 500 items.
rows[].rowRequiredintegerAt least 1.
rows[].valuesRequiredobject

The call

Over MCP, call rows_update on https://api.conecto.chat/mcp/tables. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/rows_update \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"table":"Workshop jobs","rows":[{"row":1,"values":{"Status":"Ready"}}]}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
invalid_input400A value does not fit its column, or a required column is empty; the message names the row and the column.Send values of the column's type: numbers, dates like 2026-10-22, one of a select's options.
not_found404No table has that name, the table has no column of that name, or no row has that number.Find the rows with rows_query; tables_list has the columns.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md