Skip to content

Describe the workspace database's built-in tables, columns, keys and the API resource behind each

GET
/meta/v1/schema

Success

object
engine
required
string
Allowed values: d1
kinds
required

How each logical kind is stored.

object
key
additional properties
string
tables
required
Array<object>
object
name
required
string
origin
required
string
Allowed values: built_in
label
required
string
description
required
string | null
associable
required
boolean
resource
required
object
name
required
string
surface
required
string
Allowed values: api meta
path
required

The full path of the collection, for example /api/v1/tasks.

string
operations
required
Array<string>
read_scope
required
string
write_scope
required
string | null
sorts
required

The sorts the list accepts, in the order it accepts them (convention first, then the natural fields); empty when the list takes no sort.

Array<object>
object
name
required

A value the list’s sort parameter accepts: a column of the record or a derived field.

string
kind
required

The logical kind of the sort value (see kinds): timestamp, uuid, text or integer.

string
indexed
required

True when an index serves this sort. False is a stated cost: the database sorts the organisation’s live rows in a temporary b-tree.

boolean
columns
required
Array<object>
object
name
required
string
type
required

The declared SQL type, as the database reports it (TEXT, INTEGER).

string
kind
required

The logical kind (see kinds), or null if the code does not know the column.

string | null
nullable
required
boolean
primary_key
required
boolean
default
required

The declared default expression, or null.

string | null
label
required
string
description
required
string | null
values
required

The allowed values when the record schema declares an enum for the field.

array | null
exposed
required

True when the column is a field of the API record of the table’s resource.

boolean
references
required

The table and primary-key column this column points at.

object
table
required
string
column
required
string
derived
required

Record fields computed from other tables when read; not columns.

Array<object>
object
name
required
string
kind
required

The logical kind of the value (see kinds).

string
nullable
required
boolean
writable
required

Derived fields are computed when the record is read and can never be written.

boolean
label
required
string
description
required
string | null
requires
required

The scope needed to see the field (it is absent from the record without it), or null.

string | null
filters
required

The list filters on this field.

Array<string>
sortable
required

Whether the list can be sorted by this field.

boolean
foreign_keys
required
Array<object>
object
columns
required
Array<string>
references
required
object
table
required
string
columns
required
Array<string>
on_delete
required
string
associations
required
object
table
required
string
relations
required
Array<string>
associable
required
Array<string>
description
required
string