Skip to main content
POST
Create a record

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

org_id
string
required

Org ID

table_id
string
required

Table ID

Body

id
string

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.

Maximum string length: 128
values
object

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

icon

The emoji of a curated icon a user can pick for a table, view, field, or other entity

view_id
string

The view to place the record in.

Maximum string length: 128
after
string

The neighbor to sort the record after.

Maximum string length: 1024
before
string

The neighbor to sort the record before.

Maximum string length: 1024

Response

200 - application/json
id
string
required
table_id
string
required
icon
required

The picked icon. Null falls back to the table icon.

archived
boolean
required

Whether the record is archived.

position
string | null
required

The position of the record in the view.

updated_at
string<date-time> | null
required

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

values
object[]
required

The values of the record.