Test an HTTP request column

This page documents the canonical HTTP contract for this endpoint.

This preview sends a real outbound request, but does not write table cells. It resolves templates from the chosen row (or first row by table position) and workspace secrets, then uses the public-request transport. Response fields include ok, status_code, body, headers, sanitized resolved_url, resolved_row, truncation/byte/redirect counts, and elapsed time; validation and transport failures return ok:false and an error code (with error_type for request errors). This request model is compatibility-configured and ignores extra fields.

Path parameters

table_idrequired
string
Research Table ID.

Name	Type	Description
table_idrequired	string	Research Table ID.

Body parameters

method · optional
string
HTTP method; default GET.
urlrequired
string
URL template. The request is sent to the resolved public destination.
query · optional
object
Query parameter templates; default {}.
headers · optional
object<string,string>
Header templates; default {}.
body · optional
any|null
Optional request body.
bodyMode · optional
string|null
none, text, or json; optional.
timeoutSeconds · optional
integer
Default 30 seconds; the request preparation layer validates effective bounds.
rowId · optional
string|null
Optional row ID; otherwise the first row by table position is used.

Name	Type	Description
method	string	HTTP method; default GET.
urlrequired	string	URL template. The request is sent to the resolved public destination.
query	object	Query parameter templates; default {}.
headers	object<string,string>	Header templates; default {}.
body	any\|null	Optional request body.
bodyMode	string\|null	none, text, or json; optional.
timeoutSeconds	integer	Default 30 seconds; the request preparation layer validates effective bounds.
rowId	string\|null	Optional row ID; otherwise the first row by table position is used.

Errors

Status	Meaning
401	Authentication is required.
403	The caller lacks access to the resource or the columns:write scope.
422	The request does not satisfy the route or typed request contract.

Example

bash

curl -X POST "https://app.autotouch.ai/api/tables/68d2c6a1a833d60619000001/columns/test-http-request" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "GET",
  "url": "https://api.example.test/companies/{{company_domain}}",
  "query": {},
  "headers": {},
  "bodyMode": "none",
  "timeoutSeconds": 30
}'

Request body

json

{
  "method": "GET",
  "url": "https://api.example.test/companies/{{company_domain}}",
  "query": {},
  "headers": {},
  "bodyMode": "none",
  "timeoutSeconds": 30
}

Response example

json

{
  "ok": true,
  "status_code": 200,
  "body": "{\"status\":\"ok\"}",
  "headers": {"content-type": "application/json"},
  "resolved_url": "https://api.example.test/companies/example.test",
  "resolved_row": {"company_domain": "example.test"},
  "response_truncated": false,
  "response_bytes": 15,
  "redirect_count": 0,
  "elapsed_ms": 18
}