/v1/definitions/{key}/rows/{rowId}/match-linkMatch and connect records
Finds rows on another accessible board where one selected column exactly matches the supplied value after trimming whitespace and ignoring case, then writes this row's native record-link column only when exactly one match exists. Zero or multiple matches return a branchable status and candidates without changing data. An existing different link returns conflict and is never overwritten; retrying the same link is idempotent. Use for email or a non-sensitive internal client code. Never ask a person to provide government identifiers or financial account credentials in chat; handle sensitive values only in the native app. Name source_column to match this record's own cell in that column (e.g. its Email) instead of passing match_value. The source board must be writable and the target board readable.
Access class: def:read.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredkeyed by id (a cells object by column name or id); every value is TEXT — a number, date, yes/no or list is written as a string
Responses
the action's answer
{
"data": {
"idempotent": true,
"linked": true,
"match_count": 1,
"matches": [
{
"cells": "string",
"label": "string",
"row_id": ""
}
],
"previous_target_id": "",
"status": "string",
"target_row_id": ""
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}