Create a database view

POST/v1/databases/{databaseId}/views

Request

curl -X POST "https://api.lydie.co/v1/databases/01JCQ3V5MZ8G4ZK2X7T9R6N1PB/views" \
  -H "Authorization: Bearer $LYDIE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Notes",
    "type": "table"
  }'

Path parameters

databaseIdULIDrequired

Body

idULID
namestringrequired· 1–200 chars
typestringrequired
One oftableboardlistcalendargallery
configViewConfigInput
Default {"filter":null,"sorts":[],"groupBy":null,"subGroupBy":null,"columns":[],"limit":null,"summaries":{},"layout":{},"extra":{}}
Show 9 fieldsHide fields
- filterFilterNodeor null
  Default null
- sortsobject[]
  Default []
  Show 2 fieldsHide fields
  propertyIdULIDrequired
  directionstring
  One ofascdesc
  Default "asc"
- groupByGroupByInputor null
  Default null
  Show 6 fieldsHide fields
  propertyIdULIDrequired
  directionstring
  One ofascdesc
  Default "asc"
  orderstring[]
  hideEmptyboolean
  Hide groups with no rows (board columns).
  dateBucketstring
  Date grouping; default month.
  One ofdayweekmonthyear
  collapsedstring[]
- subGroupByGroupByInputor null
  Board swimlanes.
  Default null
  Show 6 fieldsHide fields
  propertyIdULIDrequired
  directionstring
  One ofascdesc
  Default "asc"
  orderstring[]
  hideEmptyboolean
  Hide groups with no rows (board columns).
  dateBucketstring
  Date grouping; default month.
  One ofdayweekmonthyear
  collapsedstring[]
- columnsViewColumnInput[]
  Default []
  Show 3 fieldsHide fields
  propertyIdULIDrequired
  visibleboolean
  Default true
  widthinteger· 20–2000
- limitintegeror null· ≥ 1
  Default null
- summariesobject
  propertyId → summary name
  Default {}
- layoutViewLayoutInput
  Default {}
  Show 11 fieldsHide fields
  rowHeightstring
  table
  One ofshortmediumtallextra
  wrapCellsboolean
  table
  cardSizeinteger· 50–1000
  board, gallery: px
  coverobjector null
  board, gallery: the card image
  coverFitstring
  One ofcovercontain
  coverAspectRationumber· 0.1–10
  markersstring
  list
  One ofbulletnumbernone
  calendarPropertyIdULID
  calendar: the date property placing rows
  calendarModestring
  One ofmonthweek
  showWeekendsboolean
  colorColumnsboolean
  board
- extraobject
  Default {}
afterIdULID
Place directly after this sibling.
beforeIdULID
Place directly before this sibling.
sortKeystring· 1–256 chars
Explicit fractional key (recorded so replays converge).

Response

idULID
workspaceIdstring· 1–64 chars
databaseIdULID
namestring· 1–200 chars
typestring
One oftableboardlistcalendargallery
configViewConfig
Show 9 fieldsHide fields
- filterFilterNodeor null
  Default null
- sortsobject[]
  Default []
  Show 2 fieldsHide fields
  propertyIdULID
  directionstring
  One ofascdesc
  Default "asc"
- groupByGroupByor null
  Default null
  Show 6 fieldsHide fields
  propertyIdULID
  directionstring
  One ofascdesc
  Default "asc"
  orderstring[]optional
  hideEmptybooleanoptional
  Hide groups with no rows (board columns).
  dateBucketstringoptional
  Date grouping; default month.
  One ofdayweekmonthyear
  collapsedstring[]optional
- subGroupByGroupByor null
  Board swimlanes.
  Default null
  Show 6 fieldsHide fields
  propertyIdULID
  directionstring
  One ofascdesc
  Default "asc"
  orderstring[]optional
  hideEmptybooleanoptional
  Hide groups with no rows (board columns).
  dateBucketstringoptional
  Date grouping; default month.
  One ofdayweekmonthyear
  collapsedstring[]optional
- columnsViewColumn[]
  Default []
  Show 3 fieldsHide fields
  propertyIdULID
  visibleboolean
  Default true
  widthintegeroptional· 20–2000
- limitintegeror null· ≥ 1
  Default null
- summariesobject
  propertyId → summary name
  Default {}
- layoutViewLayout
  Default {}
  Show 11 fieldsHide fields
  rowHeightstringoptional
  table
  One ofshortmediumtallextra
  wrapCellsbooleanoptional
  table
  cardSizeintegeroptional· 50–1000
  board, gallery: px
  coverobjector nulloptional
  board, gallery: the card image
  coverFitstringoptional
  One ofcovercontain
  coverAspectRationumberoptional· 0.1–10
  markersstringoptional
  list
  One ofbulletnumbernone
  calendarPropertyIdULIDoptional
  calendar: the date property placing rows
  calendarModestringoptional
  One ofmonthweek
  showWeekendsbooleanoptional
  colorColumnsbooleanoptional
  board
- extraobject
  Default {}
sortKeystring· 1–256 chars
createdAttimestamp
updatedAttimestamp
deletedAttimestampor null
createdBystringor nulloptional· ≥ 1 chars
updatedBystringor nulloptional· ≥ 1 chars

200

{
  "id": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
  "workspaceId": "01JCQ3TZ0WJ8K4M2X7T9R6N1PA",
  "databaseId": "01JCQ3V5MZ8G4ZK2X7T9R6N1PB",
  "name": "Notes",
  "type": "table",
  "config": {
    "filter": null,
    "sorts": [],
    "groupBy": null,
    "subGroupBy": null,
    "columns": [],
    "limit": null,
    "summaries": {},
    "layout": {},
    "extra": {}
  },
  "sortKey": "a0",
  "createdAt": "2026-11-12T09:30:00.000Z",
  "updatedAt": "2026-11-12T09:30:00.000Z",
  "deletedAt": null,
  "createdBy": null,
  "updatedBy": null
}

Errors use one envelope for every endpoint. See Errors and versions.