Update table - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

Path parameters

table_idrequired
string
The table ID.

Name	Type	Description
table_idrequired	string	The table ID.

Body parameters

name · optional
string
New table name; command validation trims and rejects blank strings, but this route does not catch the command-model validation exception.
metadata · optional
object
Replace metadata; this is not merged with the previous object.
tableContract · optional
ResearchTableContractV1
Optional validated Research Table contract; see create-table definition.

Name	Type	Description
name	string	New table name; command validation trims and rejects blank strings, but this route does not catch the command-model validation exception.
metadata	object	Replace metadata; this is not merged with the previous object.
tableContract	ResearchTableContractV1	Optional validated Research Table contract; see create-table definition.

Errors

Status	Meaning
401	Invalid API key or missing auth.
403	Access denied.
404	Table not found.

Example

bash

curl -X PATCH "https://app.autotouch.ai/api/tables/67bd8c39c7d3e80f0a95b560" \
  -H "Authorization: Bearer stk_your_key_id.your_secret" \
  -H "Content-Type: application/json" \
  -d '{ "name": "GitHub Prospects - Q2" }'

Request body

json

{
  "name": "GitHub Prospects - Q2",
  "metadata": { "campaign": "q2-2026" }
}

Response example

json

{
  "id": "67bd8c39c7d3e80f0a95b560",
  "name": "GitHub Prospects - Q2",
  "columns": [{"id": "67bd8c39c7d3e80f0a95b561", "key": "company_name", "label": "Company name"}, {"id": "67bd8c39c7d3e80f0a95b562", "key": "website", "label": "Website"}],
  "metadata": { "campaign": "q2-2026" }
}