Tables

Create record

Create a new record in a table.

post/orgs/tables/{table_id}/records

Request

  • Base URL: https://api.useinvent.com
  • URL: https://api.useinvent.com/orgs/tables/{table_id}/records
  • Auth: HTTP bearer

Path parameters

table_idstring required

Table ID

Request body

idstring

Client-generated id for the new record (enables optimistic creation). Encoded (rec_…) or raw UUID — use UUID v7 to keep ids time-sortable. Rejected if already in use.

valuesSetTableRecordValuesSchema

Map of field key → value. Multi-value fields accept arrays; pass null or [] to clear.

view_idstring

The view to place the record in.

afterstring

The neighbor to sort the record after.

beforestring

The neighbor to sort the record before.

Response

idstring required
table_idstring required
archivedboolean required

Whether the record is archived.

positionstring nullable required

The position of the record in the view.

updated_atstring date-time nullable required

Last modification time. Total-orders concurrent updates so caches can keep the newest copy.

Example response

{
  "values": [
    {
      "display": {
        "file_filename": "document.pdf",
        "file_size": 1024,
        "file_mimetype": "application/pdf"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.