/v1/definitions/{key}/importsImport a spreadsheet into a page
Records one FINISHED import in a page's history — fileName, total, imported, failed, an error if it went wrong, and the per-row results. It imports NOTHING: this is the ledger entry for an import the caller already ran itself. To actually import rows use post_definitions_key_import, post_definitions_key_import_auto (a spreadsheet mapped for you) or post_definitions_key_import_jobs. Counts that do not add up — imported plus failed exceeding total — are refused.
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/jsonrequiredResponses
the action's answer
{
"data": {
"actorUserId": 1,
"createdAt": "string",
"error": "string",
"failed": 1,
"fileName": "string",
"finishedAt": "string",
"id": "",
"imported": 1,
"keptCount": 1,
"results": [
{
"error": "string",
"id": "",
"name": "string",
"row": "string",
"skipped": "string"
}
],
"standing": 1,
"status": "string",
"total": 1,
"undoneAt": "string",
"undoneBy": 1,
"undoneCount": 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"
}