/v1/definitions/{key}/rows/{rowId}/subrecordsAttach or create a subrecord
Hang a child record under this one. Pass childKey plus childRowId to attach an EXISTING record, or childKey plus cells to create a new child on that page and attach it in one transaction. The child page must be one this page accepts (see GET /v1/definitions/:key/child-pages), and the database refuses an undeclared pair. This is how a record holds MANY items (an order's line items): one child per item, never a select or a list in one cell.
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 column name (or id); every value is TEXT — a number or true/false is taken as its text, null empties the cell, a date or a list is written as a string
Responses
the action's answer
{
"data": {
"cells": {},
"childKey": "string",
"childName": "string",
"childRowId": "",
"createdAt": "2026-01-01T00:00:00Z",
"createdByUserId": 1,
"id": "",
"kind": "string",
"position": 1
}
}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"
}