POST/v1/ingest/rows

Add rows

Add one row (cells), or up to 500 (rows) all or nothing. Scope rows:write.

Send request

Use the documented inputs to call this endpoint directly.

API serverbase URL

Bearer tokenboardKeyoptional

Stored only in this browser for the boardKey security scheme and reused on every API page in this group.

Request body

application/jsonrequired

Responses

201application/json

Written. One row answers data plus its receipt; a batch answers data and receipts as lists.

{
  "data": {
    "id": "",
    "position": 1,
    "source": "string",
    "cells": {},
    "createdBy": "string"
  },
  "filled": [
    "string"
  ],
  "coerced": [
    {
      "column": "string",
      "sent": "string",
      "stored": "string"
    }
  ],
  "ignored": [
    {
      "column": "string",
      "why": "string"
    }
  ]
}

400application/json

A cell or the body is wrong; nothing was written.

{
  "error": {
    "message": "string",
    "errors": [
      {
        "index": 1,
        "message": "string"
      }
    ]
  }
}

errorrequired

401application/json

No key, or an unknown or revoked one.

{
  "error": {
    "message": "string",
    "errors": [
      {
        "index": 1,
        "message": "string"
      }
    ]
  }
}

errorrequired

403application/json

The key was not given rows:write.

{
  "error": {
    "message": "string",
    "errors": [
      {
        "index": 1,
        "message": "string"
      }
    ]
  }
}

errorrequired

429application/json

Over 120 requests a minute; wait Retry-After seconds.

{
  "error": {
    "message": "string",
    "errors": [
      {
        "index": 1,
        "message": "string"
      }
    ]
  }
}

errorrequired